Este endpoint permite recuperar uma lista de envios usando package_id, external_reference_id, payment_id ou payment_intent_id como filtros. Retorna informações detalhadas sobre os envios incluindo status, endereços, pacotes e informações de rastreamento. Em caso de sucesso, a requisição retornará uma resposta com o status 200.
GET
OBRIGATÓRIO
400Requisição inválida. Os parâmetros enviados não são válidos.
bad_request
Dados inválidos foram enviados no body da requisição. Tente enviar a solicitação novamente, validando todos os campos.
401Não autorizado. Credenciais inválidas ou ausentes.
unauthorized
O valor enviado como Access Token está incorreto. Verifique e tente enviar a requisição novamente com o valor correto.
417Expectativa falhou.
expectation_failed
Não foi possível atender à expectativa especificada no header Expect. Valide as informações enviadas e tente enviar a requisição novamente.
500Erro interno do servidor.
internal_server_error
Ocorreu um erro inesperado no servidor. Tente enviar a requisição novamente.
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=131245840212'\
-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",
"city_locality": "México",
"state_province": "CDMX",
"complement": "Detalle",
"zip_code": "06760",
"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"
},
"tracking_url": "https://www.mercadopago.com.mx/shipping-tracking?id=000038774013",
"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": "24.50"
}
],
"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"
}
}
]
}