Este endpoint permite recuperar una lista de envíos basándose en el ID del paquete, referencia externa, ID de pago o ID de intención de pago. Devuelve información detallada sobre los envíos incluyendo estado, direcciones, paquetes e información de seguimiento. En caso de éxito, la solicitud devolverá una respuesta con el estado 200.
GET
REQUERIDO
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.
curl -X GET \
'https://api.mercadopago.com/shipping/v1/shipments?package_id=43434-3dfe-46d4-8237-546556fgh&external_reference_id=REF-123456&payment_id=123456&payment_intent_id=4554565545-d13353c3-525c-442e-b101-27b892b2746d'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer APP_USR-4*********994754-12*********c73b4e1ac*********cef36b27c*********840' \
{
"data": [
{
"external_reference_id": "REF-123456",
"shipment_id": "e522fa4a-c3f8-4f34-a353-16f45a012345",
"shipment_status": "ready",
"active_phase": "forward",
"created_at": "2025-07-03T18:46:03.645897682",
"shipping_to": {
"address": "Dirección del comprador",
"country_code": "MX"
},
"shipping_from": {
"phone": "987-654-321",
"contact": "Miguel Hernández",
"address": "Dirección del vendedor",
"city_locality": "México",
"state_province": "CDMX",
"complement": "Detalle",
"zip_code": "03940",
"country_code": "MX"
},
"packages": [
{
"id": "96b67f13-753e-4f23-b087-cb4d46383f4s6",
"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_info": {
"tracking_number": "96b67f13-753e-4f23-b087-cb4d46381d1d",
"last_status": "ready",
"updated_at": "2025-07-03T18:46:07.136506537"
}
}
],
"dispatch_date": {
"from": "2025-07-05T06:00:00Z"
}
}
]
}