Este endpoint permite recuperar uma lista de envios com base no ID do pacote, referência externa, ID de pagamento ou ID de intenção de pagamento. 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 a enviar 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=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"
}
}
]
}