Consultar seguimiento de envío

Este endpoint permite recuperar información detallada de seguimiento para un paquete específico usando su número de seguimiento. Devuelve el historial completo de seguimiento incluyendo todos los eventos, detalles del paquete y estado actual. Esto es útil para proporcionar visibilidad del envío a los clientes. En caso de éxito, la solicitud devolverá una respuesta con el estado 200.

GET

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

REQUERIDO

Access Token obtenido a través del panel de desarrollador. Obligatorio ser enviado en todas las solicitudes.
Path
tracking_number
string

REQUERIDO

Número de seguimiento del paquete para recuperar información de seguimiento.
Response parameters
tracking_number
string
Número de seguimiento del envío del paquete.
package
object
tracking
array
Detalles del histórico del envío.
Errors

400Solicitud inválida. Los parámetros enviados no son válidos.

bad_request

Se enviaron datos inválidos en el body de la solicitud. Vuelve a intentar enviar la solicitud, validando todos los campos.

401No autorizado. Credenciales inválidas o faltantes.

unauthorized

El valor enviado como Access Token es incorrecto. Por favor, verifícalo y vuelve a realizar la solicitud enviando el valor correcto.

417Expectativa fallida.

expectation_failed

No se pudo cumplir con la expectativa especificada en el header "Expect". Valida la información enviada y vuelve a intentarlo.

500Error interno del servidor.

internal_server_error

Ocurrió un error inesperado en el servidor. Vuelve a intentar la solicitud.

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"
    }
  ]
}