Tracking

Operaciones

Consultar estado de rastreo por número de rastreo (con offset UTC)

Solicitud

Recupera el evento de rastreo actual del envío, el primer evento de rastreo registrado y el historial completo de eventos de rastreo según lo reportado por el transportista.

Este endpoint devuelve todas las marcas de tiempo de los eventos de rastreo en formato ISO 8601 incluyendo el offset UTC, lo que permite a los clientes interpretar con precisión las horas locales de los eventos en distintas zonas horarias.

Seguridad

BearerAuth

Consulta

tracking_nostringrequerido

número de rastreo

Ejemplo:tracking_no=940013620842281000000

carrier_codestringrequerido

código del transportista

Ejemplo:carrier_code=USPS

GET

/api/shipment/direct/tracking_by_tracking_no

curl -i -X GET \
  'https://x-api.shipsaving.com/api/shipment/direct/tracking_by_tracking_no?tracking_no=940013620842281000000&carrier_code=USPS' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Respuestas

Cuerpoapplication/json

codestring

Código de respuesta de la API; "ok" indica éxito.

Ejemplo:"ok"

msgstring

Mensaje de respuesta legible por humanos.

Ejemplo:"ok"

dataobject(TrackingDataWUtcOffset)

Este es el registro de rastreo más reciente.

Response

{
  "code": "ok",
  "msg": "ok",
  "data": {
    "status": "in_transit",
    "message": "USPS in possession of item",
    "status_summary": "Your item has been delivered and is available at xxx at 9:00 am on xxx in xxxx, xx 20000.",
    "recipient_name": "Alice",
    "scanned_time": "2025-12-16T10:48:28-05:00",
    "location": { … },
    "return_to_sender": true,
    "first_scan_date": "2025-11-14T14:07:33-05:00",
    "first_scan_description": "Package is in transit to a UPS facility",
    "first_scan_location": { … },
    "tracking_events": [ … ]
  }
}