To rate a shipment, send a POST to the endpoint /shipping/v1/shipments-rates including your Access TokenPrivate key of the application created in Mercado Pago, used in the backend. You can access it through Your integrations > Application details > Testing > Test credentials. and the parameters described in the table below. Keep in mind that only one package can be quoted at a time.

curl
Copiar
curl --location 'https://api.mercadopago.com/shipping/v1/shipments-rates' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer [Access Token]' \
--data '{
    "packages": [
        {
	     "declared_value": 1500,	
            "quantity": 1,
            "dimensions": {
                "weight": 500,
                "width": 30,
                "height": 30,
                "length": 30
            }
        }
    ],
    "shipping_from": {
        "zip_code": "06760"
    },
    "shipping_to": {
        "zip_code": "06720"
    }
}'

If the request is correct, the response will return the shipping rate, which may contain more than one option varying in price and/or delivery time.

json
Copiar
{
    "shipment_rate_id": "be9fae0d-1079-471e-887d-55861965d10e",
    "rates": [
        {
            "options": [
                {
                    "id": "3c86ea36-fef7-4a9e-9092-d4eb6e744834",
                    "pricing": {
                        "base_price": "87",
                        "price": "87",
                        "discounts": []
                    },
                    "method": "standard",
                    "pay_before": "2025-10-27T00:00:00-06:00",
                    "delivery_promise": {
                        "shipping_from": "2025-10-28T12:00:00-06:00",
                        "shipping_to": "2025-10-30T12:00:00-06:00"
                    },
                    "delivery_days": {
                        "from": 3,
                        "to": 5
                    }
                }
            ],
            "packages": [
                {
                    "quantity": 1,
                    "dimensions": {
                        "weight": "500",
                        "width": "30",
                        "height": "30",
                        "length": "30"
                    }
                }
            ]
        }
    ],
    "shipping_to": {
        "zip_code": "06720",
        "country_id": "MX",
        "city_id": "TUxNQ0NVQTczMTI",
        "state_id": "MX-DIF"
    }
}

To learn about the errors this request may return, go to our API Reference.

It is possible to query a shipment and obtain its complete data once created. This query will allow you to access the package identifier (packages.id) and the tracking number (tracking_number), among other data.

To do so, send a GET with your Access TokenPrivate key of the application created in Mercado Pago, used in the backend. You can access it through Your integrations > Application details > Testing > Test credentials. to the endpoint /shipping/v1/shipments/{shipment_id} including the shipment identifier (shipment_id) in the request path.

curl
Copiar
curl --location 'https://api.mercadopago.com/shipping/v1/shipments/e522fa4a-c3f8-4f34-a353-16f45a012345' \
--header 'Authorization: Bearer [Access Token]'

Optionally, you can also send the following parameters as query parameters to filter the query:

If the request is correct, the response will look like the example below.

json
Copiar
{
    "data": [
        {
            "external_reference_id": "External reference",
            "shipment_id": "e522fa4a-c3f8-4f34-a353-16f45a012345",
            "shipment_status": "ready",
            "active_phase": "forward",
            "created_at": "2025-07-03T18:46:03.645897682",
            "shipping_to": {
                "address": "Buyer's address",
                "city_locality": "City",
                "state_province": "State",
                "complement": "Detail",
                "zip_code": "06250",
                "country_code": "MX"
            },
            "shipping_from": {
                "phone": "1234567890",
                "contact": "Seller's name",
                "address": "Seller's address",
                "city_locality": "City",
                "state_province": "MEX",
                "complement": "",
                "zip_code": "54963",
                "country_code": "MX"
            },
            "packages": [
                {
                    "id": "96b67f13-753e-4f23-b087-cb4d46383f4s6",
                    "dimensions": {
                        "height": 10,
                        "length": 10,
                        "width": 10,
                        "weight": 100,
                        "volume": null
                    },
                    "items": [
                        {
                            "title": "Product",
                            "description": "Product description",
                            "unit_price": 100
                        }
                    ],
                    "price": {
                        "amount": "100",
                        "currency": "MXN"
                    },
                    "tracking_info": {
                        "tracking_number": "96b67f13-753e-4f23-b087-cb4d46381d1d",
                        "last_status": "ready",
                        "updated_at": "2025-07-03T18:46:07.136506537"
                    }
                }
            ],
            "origin": {
                "zip_code": "45601",
                "city": "Tlaquepaque",
                "state": "Jalisco",
                "country": "Mexico",
                "neighborhood": "La Calerilla",
                "address_line": "Calz de Guadalupe 432",
                "references": "200 Referencia: Casa blanca y azul."
            },
            "dispatch_date": {
                "from": "2025-07-05T06:00:00Z"
            }
        }
    ]
}

With the Labels API, you can generate labels containing all the necessary information to dispatch packages of your sold products. You can choose whether you want this label to be generated in PDF, ZIP or ZPL format for download, or in JSON format.

To generate the label, send a GET with your Access TokenPrivate key of the application created in Mercado Pago, used in the backend. You can access it through Your integrations > Application details > Testing > Test credentials. and the parameters indicated in the table below to the endpoint /shipping/v1/shipments/{id}/packages/{package_id}/label.

curl
Copiar
curl --location 'https://api.mercadopago.com/shipping/v1/shipments/1371769672-9785ed21-f66d-4290-a628-434343434/packages/678029ce4265b922a299999/label' \
--header 'X-Content-Type: json' \
--header 'Authorization: Bearer [Access Token] '

The response may vary depending on the output format specified in the request, but it will always contain a label identifier (id) and its content (label). If requested to be generated as a PDF, ZIP or ZPL file, it will contain the downloadable file.

json
Copiar
[
    {
        "id": 43539204818,
        "label": "String"
    }
]

To learn about the errors this request may return, go to our API Reference.

With the Shipments API you can track dispatched packages using their tracking number. To do so, send a GET to the endpoint /shipping/v1/shipments-tracking/{tracking_number}, including only the package's tracking number (tracking_number) in the request path.

curl
Copiar
curl --location 'https://api.mercadopago.com/shipping/v1/shipments-tracking/343434ereer-3344e33rre3' \
--header 'Authorization: Bearer [Access Token]'

If the data sent is correct, the response will contain the package information along with the shipment events, as shown in the response below.

json
Copiar
{
    "tracking_number": "343434ereer-3344e33rre3",
    "package": {
        "id": "1",
        "external_reference_id": "External reference",
        "dimensions": {
            "height": 10,
            "length": 10,
            "width": 10,
            "weight": 10,
            "volume": 10
        },
        "items": [
            {
                "title": "Product",
                "description": "Product description",
                "unit_price": 2007.66
            }
        ],
        "price": {
            "amount": 2007.66,
            "currency": "MXN"
        }
    },
    "tracking": [
        {
            "type": "forward",
            "events": [
                {
                    "status": "created",
                    "date": "2024-08-22T13:40:00.095Z"
                },
   {
                    "event_name": "ready",
                    "event_date": "2025-06-09T18:40:24.749252964Z"
                },
                {
                    "status": "shipped",
                    "date": "2024-08-23T10:40:00.095Z"
                },
                {
                    "status": "in_hub",
                    "date": "2024-08-23T11:40:00.095Z"
                },
                {
                    "status": "outbounded",
                    "date": "2024-08-23T13:40:00.095Z"
                },
                {
                    "status": "out_for_delivery",
                    "date": "2024-08-23T13:45:00.095Z"
                },
                {
                    "status": "delivered",
                    "date": "2024-08-23T14:45:00.095Z"
                }
            ]
        }
    ]
}

To learn about the errors this request may return, go to our API Reference.

Below you can consult the possible shipment statuses along with their description and association with the direction in which the shipment moves.