# 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** `/shipping/v1/shipments-tracking/{tracking_number}`

## Request parameters

### Path

- `tracking_number` (string, required)
  Tracking number of the package to retrieve tracking information.

## Response parameters

- `tracking_number` (string, optional)
  Package tracking number.

- `tracking_url` (string, optional)
  Link for the buyer to check the shipment status in real time.

- `package` (object, optional)

  - `package.id` (string, optional)
  Unique identifier of the shipped package.

  - `package.external_reference_id` (string, optional)
  External reference that you can synchronize with your payment system to identify the shipment.

  - `package.dimensions` (object, optional)
  Object containing information about the item size including weight, width, height, length, and volume.

  - `package.dimensions.weight` (number, optional)
  Weight of the item in grams.

  - `package.dimensions.width` (number, optional)
  Width of the item in centimeters.

  - `package.dimensions.height` (number, optional)
  Height of the item in centimeters.

  - `package.dimensions.length` (number, optional)
  Length of the item in centimeters.

  - `package.dimensions.volume` (number, optional)
  Volume of the item in cubic centimeters.

  - `package.items` (array, optional)

  - `package.items[].title` (string, optional)
  Title of the item sent in the package.

  - `package.items[].description` (string, optional)
  Description of the item sent in the package.

  - `package.items[].unit_price` (number, optional)
  Value of the item sent in the package.

  - `package.price` (object, optional)
  Price information of the shipment.

  - `package.price.amount` (string, optional)
  Shipping amount.

  - `package.price.currency` (string, optional)
  Currency used in the shipment.

- `tracking` (array, optional)
  Shipping history details.

  - `tracking[].type` (string, optional)
  Direction of the shipment.
Possible enum values:

  - `forward`
  Shipment is moving forward to the customer.

  - `reverse`
  Shipment is moving back to the seller.

## Errors

| Status | Error | Description |
| ------- | ------- | ----------- |
| 400 | bad_request | Invalid data was sent in the request body. Try sending the request again, validating all fields. |
| 401 | unauthorized | The value sent as Access Token is incorrect. Please check and try again with the correct value. |
| 417 | expectation_failed | Could not meet the expectation specified in the "Expect" header. Validate the information sent and try the request again. |
| 500 | internal_server_error | An unexpected error occurred on the server. Try the request again. |

## Request example

### cURL

```bash
curl -X GET \
  'https://api.mercadopago.com/shipping/v1/shipments-tracking/{tracking_number}' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <ACCESS_TOKEN>'
```

## Response example

```json
{
  "tracking_number": "343434ereer-3344e33rre3",
  "tracking_url": "https://www.mercadopago.com.mx/shipping-tracking?id=000038774013",
  "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": "24.50"
  }
  ],
  "price": {
  "amount": "24.50",
  "currency": "MXN"
  }
  },
  "tracking": [
  {
  "type": "forward"
  }
  ]
}
```