Management of shipping fees

Query products with free shipping

This endpoint allows us to check which products are offered with free shipping.

Request:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN'https://api.mercadolibre.com/items/$ITEM_ID

Example:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN'https://api.mercadolibre.com/items/MLA1122334488

Response with optional free shipping:

"shipping": {
	"mode": "me2",
	"methods": [],
	"tags": [
		"self_service_in"
	],
	"dimensions": null,
	"local_pick_up": false,
	"free_shipping": true,
	"logistic_type": "cross_docking",
	"store_pick_up": false
}

Response with mandatory free shipping:

"shipping": {
	"mode": "me2",
	"methods": [],
	"tags": [
		"mandatory_free_shipping"
	],
	"dimensions": null,
	"local_pick_up": true,
	"free_shipping": true,
	"logistic_type": "xd_drop_off",
	"store_pick_up": false
}

Response with free shipping outside me2:

"shipping": {
	"mode": "not_specified",
	"methods": [],
	"tags": [],
	"dimensions": null,
	"local_pick_up": true,
	"free_shipping": true,
	"logistic_type": "not_specified",
	"store_pick_up": false
}

"shipping": {
	"mode": "me1",
	"methods": [],
	"tags": [
		"optional_me1_chosen"
	],
	"dimensions": "56x190x140,59250",
	"local_pick_up": false,
	"free_shipping": true,
	"logistic_type": "default",
	"store_pick_up": false
}

Response parameters:

• shipping.mode: shipping method set up for the item.
• shipping.tags: item shipping labels.

• If it states "mandatory_free_shipping" it’s because the item exceeded the limit established by Mercado Libre. For these products, free shipping is mandatory. Sellers must offer free shipping or an important discount in the shipping
• On the other hand, for products with a price lower than that limit, free shipping is optional.

• shipping.dimensions: product dimensions in this format: height, width, length, weight.
• shipping.local_pick_up: boolean indicator that shows if the pickup in person option is available.
• shipping.free_shipping: boolean indicator that shows if the shipping is free.
• shipping.logistic_type: type of shipping logistics.
• shipping.store_pick_up: boolean indicator that shows if the pickup at the store option is available.

To get a detailed overview of the prices for free shipping, please check the following pages:

Query shipping costs

This endpoint allows us to learn the price the seller will pay for the shipping of an item.
It can also be used to simulate shipping costs when publishing or editing an item.

Request:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN'https://api.mercadolibre.com/users/$USER_ID/shipping_options/free?dimensions=$DIMENSIONES&verbose=$VERBOSE&item_price=$ITEM_PRICE&listing_type_id=$LISTING_TYPE&mode=$MODE&condition=$CONDITION&logistic_type=$LOGISTIC_TYPE

Example:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN'https://api.mercadolibre.com/users/244878077/shipping_options/free?dimensions=9x17x22,462&verbose=true&item_price=300&listing_type_id=gold_pro&mode=me2&condition=new&logistic_type=drop_off

Acceptable query parameters:

Response:

"{
    "coverage": {
        "all_country": {
            "list_cost"": 2369.99,
            "currency_id": "ARS",
            "billable_weight": 462,
            "discount": {
                "rate": 0,
                "type": "none",
                "promoted_amount": 0
            }
        }
    }
}"

Response parameters:

• coverage: it represents the shipping coverage and contains information about costs and currency used for it.
• coverage.all_country: within "coverage", "all_country" specifies that the information applies to nationwide shipments.
• coverage.all_country.list_cost: shipping fee offered to the seller.
• coverage.all_country.currency_id: currency used for the shipment fee.
• coverage.all_country.billable_weight: billable weight of the shipment.
• coverage.discount: information about discounts applied to the shippino.
• coverage.discount.rate: discount fee applied.
• coverage.discount.type: describes the type of discount.
• coverage.discount.promoted_amount: base amount or value over which a determined discount percentage will be applied. For example, if we have a shipping fee of $200 and a 40% discount is applied, in the final response we would have: list_cost = 120, rate: 0.4 and promoted_amount = 200.

Response status codes:

Regarding Mercado Shops, it's important to point out that, currently, we do not have a specific API to check shipping fees. However, we want to provide valuable information related to the business rules applied, like the amounts or ranges established to offer free shipping.

Siguiente: Places (xd_drop_off).