We’re making changes on our free shippings options by country: From now on seller’s will have a country flat rate for the items they free ship. This rate is going to be calculated basing on dimensions.

By now it’s only available on MercadoLibre México (MLM), but soon it’s going to work for all sites where our MercadoEnvios unit is active: Argentina, Brazil & Colombia as well. Follow this guide to know what options you have available for free shipping your items on MLM.

Sites

Calculate free shipping costs by site & item dimensions

Example:

curl -X GET https://api.mercadolibre.com/sites/MLM/shipping_options/free?dimensions=2x11x25,500

Response:

{
    "coverage": {
        "all_country": {
            "list_cost": 97,
            "currency_id": "MXN"
        }
    }
}

Users & items

On México we offer seller’s a single flat rate option. When dimensions aren’t specified on the item, calculate is done basing on standard category dimensions.

Know standard dimensions for a given category

Example:

curl -X GET https://api.mercadolibre.com/categories/MLM165702/shipping

Response:

{
    "category_id": "MLM1055",
    "height": 10,
    "width": 10,
    "length": 15,
    "weight": 500
}
Calculate free shipping costs by user & item dimensions

Example:

curl -X GET https://api.mercadolibre.com/users/4422224/shipping_options/free?dimensions=10x10x10,500

Response:

{
    "coverage": {
        "all_country": {
            "list_cost": 97,
            "currency_id": "MXN"
        }
    }
}
Calculate free shipping costs by user & item_id

Example:

curl -X GET https://api.mercadolibre.com/users/4422224/shipping_options/free?item_id=MLM531425223
{
    "coverage": {
        "all_country": {
            "list_cost": 97,
            "currency_id": "MXN"
        }
    }
}
Calculate free shipping costs by item

Example:

curl -X GET https://api.mercadolibre.com/items/MLM540832430/shipping_options/free

Response:

{
  "coverage": {
    "all_country": {
      "list_cost": 105,
      "currency_id": "MXN"
    }
  }
}

Use multiget to calculate the cost of free shipping up to 50 items on one API call:

Example:

curl -X GET curl -X GET https://api.mercadolibre.com/items/shipping_options/free?ids=MLM531425223,MLM537956425,MLM537955922

Response:

{
    "MLM537955922": {
        "coverage": {
            "all_country": {
                "list_cost": 140,
                "currency_id": "MXN"
            }
        }
    },
    "MLM531425223": {
        "coverage": {
            "all_country": {
                "list_cost": 97,
                "currency_id": "MXN"
            }
        }
    },
    "MLM537956425": {
        "coverage": {
            "all_country": {
                "list_cost": 105,
                "currency_id": "MXN"
            }
        }
    }
}

Please, rate this article