Consultar rastreio de envio

Este endpoint permite recuperar informações detalhadas de rastreamento para um pacote específico usando seu número de rastreamento. Retorna o histórico completo de rastreamento incluindo todos os eventos, detalhes do pacote e status atual. Isso é útil para fornecer visibilidade do envio aos clientes. Em caso de sucesso, a requisição retornará uma resposta com o status 200.

GET

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

OBRIGATÓRIO

Access Token obtido através do painel de desenvolvedores. Obrigatório ser enviado em todas as requisições.
Path
tracking_number
string

OBRIGATÓRIO

Número de rastreamento do pacote para recuperar informações de rastreamento.
Response parameters
tracking_number
string
Número de rastreamento do pacote.
package
object
tracking
array
Detalhes do histórico de envio.
Erros

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.

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