Get shipment tracking

This endpoint allows to retrieve detailed tracking information for a specific package using its tracking number. It returns the complete tracking history including all events, package details, and current status. This is useful for providing shipment visibility to customers. In case of success, the request will return a response with status 200.

GET

https://api.mercadopago.com/shipping/v1/shipments-tracking/{tracking_number}
Request parameters
Header
Authorization
string

REQUIRED

Access Token obtained through the developer panel. Must be sent in all requests.
Path
tracking_number
string

REQUIRED

Tracking number of the package to retrieve tracking information.
Response parameters
tracking_number
string
Package tracking number.
package
object
tracking
array
Shipping history details.
Errors

400Bad request. The parameters sent are not valid.

bad_request

Invalid data was sent in the request body. Try sending the request again, validating all fields.

401Unauthorized. Invalid or missing credentials.

unauthorized

The value sent as Access Token is incorrect. Please check and try again with the correct value.

417Expectation failed.

expectation_failed

Could not meet the expectation specified in the "Expect" header. Validate the information sent and try the request again.

500Internal server error.

internal_server_error

An unexpected error occurred on the server. Try the request again.

Request
curl -X GET \
    'https://api.mercadopago.com/shipping/v1/shipments-tracking/{tracking_number}'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer APP_USR-4*********994754-12*********c73b4e1ac*********cef36b27c*********840' \
    
Response
{
  "tracking_number": "343434ereer-3344e33rre3",
  "package": {
    "id": "1",
    "external_reference_id": "REF-123456",
    "dimensions": {
      "weight": 10,
      "width": 10,
      "height": 10,
      "length": 10,
      "volume": 10
    },
    "items": [
      {
        "title": "Producto",
        "description": "Descripción del producto",
        "unit_price": 100
      }
    ],
    "price": {
      "amount": "24.50",
      "currency": "MXN"
    }
  },
  "tracking": [
    {
      "type": "forward"
    }
  ]
}