Seguimiento | Conector de Redes

GET/v1/shipments/{shipment_id}/tracking-events

tracking:read

Consultar el historial

Los eventos se devuelven del más reciente al más antiguo. El parámetrolimit admite entre 1 y 200 elementos y utiliza 100 por defecto.

Primera página

curl --request GET \
  --url "$API_BASE_URL/v1/shipments/274a2a5d-fef4-4fc6-9057-39d8df258367/tracking-events?limit=100" \
  --header "Authorization: Bearer $SENDINGBAY_API_TOKEN"

Respuesta de ejemplo

{
  "items": [{
    "id": "5a7d5058-ec5d-4dd4-b152-c14376a03e71",
    "status": "in_transit",
    "source": "carrier_poll",
    "effective_at": "2026-09-10T11:58:00Z",
    "received_at": "2026-09-10T12:00:04Z",
    "provider_status_code": "HUB",
    "provider_status_description": "Clasificado en plataforma",
    "location": {
      "city": "Madrid",
      "postal_code": "28042",
      "country_code": "ES",
      "facility_name": "Centro logístico",
      "facility_code": "MAD-01"
    },
    "reason_code": null,
    "reason_description": null,
    "status_mapping_version": 3
  }],
  "next_cursor": "8f152bd5-3d13-47bd-a5d7-fec51492a857"
}

Paginar sin interpretar el cursor

Si next_cursor contiene un valor, envíalo comocursor en la siguiente petición. No lo fabriques ni lo reutilices para otro envío. Un cursor inválido devuelveinvalid_tracking_cursor.

Página siguiente

curl --request GET \
  --url "$API_BASE_URL/v1/shipments/274a2a5d-fef4-4fc6-9057-39d8df258367/tracking-events?limit=100&cursor=8f152bd5-3d13-47bd-a5d7-fec51492a857" \
  --header "Authorization: Bearer $SENDINGBAY_API_TOKEN"

Estados canónicos

Estado	Significado
`accepted`	La solicitud fue aceptada para procesamiento.
`created`	La expedición quedó creada en el transportista.
`in_transit`	Circula por la red logística.
`out_for_delivery`	Está en reparto final.
`available_for_pickup`	Espera retirada en un punto u oficina.
`delivered`	Fue entregada.
`delivery_failed`	Hubo un intento de entrega fallido.
`exception`	Existe una incidencia que requiere atención.
`return_in_transit`	Está regresando al remitente.
`returned`	Fue devuelta al remitente.
`cancelled`	El transportista informa que fue cancelada.
`unknown`	Llegó un código externo sin correspondencia activa.

Leer correctamente un evento

effective_at: Momento en que ocurrió el hecho logístico.
received_at: Momento en que el Conector recibió y guardó el evento.
source: system: Evento inicial creado junto con el envío.carrier_poll: Actualización obtenida consultando al transportista.carrier_webhook: Actualización recibida desde un webhook del transportista.
provider_*: Código y descripción originales. Úsalos para diagnóstico, no para controlar tu lógica de negocio.
location y reason_*: Contexto opcional que puede contener información operativa o datos personales; aplica tu política de retención.

Siguiente lectura

Recibe cambios sin consultar continuamente.

Ir a webhooks →