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

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.

Endpoint: GET /api/shipment/direct/tracking_by_tracking_no
Version: v2
Security: BearerAuth

## Query parameters:

  - `tracking_no` (string, required)
    número de rastreo

  - `carrier_code` (string, required)
    código del transportista

## Response 200 fields (application/json):

  - `code` (string)
    Código de respuesta de la API; "ok" indica éxito.
    Example: ok

  - `msg` (string)
    Mensaje de respuesta legible por humanos.
    Example: ok

  - `data` (object)
    Este es el registro de rastreo más reciente.

  - `data.status` (string)
    Estado actual del envío. Los valores posibles incluyen:
- **created**: La etiqueta de envío ha sido generada pero aún no ha sido escaneada por el transportista.
Indica que el proceso de envío aún no ha comenzado.
- **available_for_pickup**: El paquete ha llegado a una ubicación designada y está esperando a que el destinatario lo recoja.
Indica que se requiere acción del cliente para retirar el envío.
- **in_transit**: El paquete se encuentra en tránsito, pasando por diferentes instalaciones o puntos de control.
Indica que el envío está en camino pero aún no ha llegado al destino.
- **out_for_delivery**: El paquete ha sido entregado al mensajero y se encuentra en su ruta final de entrega.
Indica que el envío está en la etapa de entrega de última milla.
- **delivered**: El paquete ha sido entregado con éxito y firmado por el destinatario.
Indica que el proceso de envío se ha completado.
- **return_to_sender**: El paquete está siendo devuelto al remitente debido a una entrega fallida u otros motivos.
Indica un proceso de logística inversa.
- **voided**: La etiqueta de envío ha sido anulada y el paquete no será procesado.
Indica que el envío ha sido cancelado o invalidado.
- **error**: Se produjo un error durante el procesamiento del envío.
Indica incidencias del lado del transportista que pueden requerir intervención manual.
- **seized_by_law_enforcement**: El paquete fue incautado por las autoridades policiales.
Indica problemas de cumplimiento o legales que afectan al envío.
- **unknown**: Se desconoce el estado del envío o el transportista no proporciona una actualización válida.
Indica que no hay información de rastreo disponible en este momento.
    Enum: "created", "available_for_pickup", "in_transit", "out_for_delivery", "delivered", "return_to_sender", "voided", "error", "seized_by_law_enforcement", "unknown"

  - `data.message` (string)
    Descripción legible por humanos del estado.
    Example: USPS in possession of item

  - `data.status_summary` (string)
    El resumen del estado.
    Example: Your item has been delivered and is available at xxx at 9:00 am on xxx in xxxx, xx 20000.

  - `data.recipient_name` (string)
    El nombre de la persona que firma la entrega (si está disponible).
    Example: Alice

  - `data.scanned_time` (string)
    Marca de tiempo en la que se escaneó el paquete, devuelta en formato ISO 8601 con el desfase UTC incluido para indicar la zona horaria local.
    Example: 2025-12-16T10:48:28-05:00

  - `data.location` (object)
    Información de ubicación reportada por el transportista. Los campos como city, state, zipcode y country pueden devolverse según la disponibilidad de los datos del transportista.

  - `data.location.city` (string)
    Example: BROOKLYN

  - `data.location.state` (string)
    Example: NY

  - `data.location.zipcode` (string)
    Example: 91777

  - `data.location.country` (string)

  - `data.return_to_sender` (boolean)
    Indica si el envío ha sido devuelto al remitente.
Este campo siempre está presente en la respuesta cuando el código de estado es 200, independientemente del estado de rastreo actual.
- false: El envío no ha sido devuelto al remitente.
- true: El envío ha sido devuelto al remitente.
    Example: true

  - `data.first_scan_date` (string)
    Marca de tiempo del primer escaneo del transportista para el envío, que indica cuándo
el paquete fue procesado o recibido inicialmente por el transportista. Se devuelve en
formato ISO 8601 con el desfase UTC incluido para representar la hora local del evento.
    Example: 2025-11-14T14:07:33-05:00

  - `data.first_scan_description` (string)
    Descripción del primer evento de escaneo del transportista. Indica el estado inicial o el mensaje de procesamiento registrado cuando el envío fue escaneado por primera vez.
    Example: Package is in transit to a UPS facility

  - `data.tracking_events` (array)

  - `data.tracking_events.status` (string)
    Example: in_transit

  - `data.tracking_events.message` (string)
    Descripción legible por humanos.
    Example: Arrived at USPS Facility

  - `data.tracking_events.event_time` (string)
    Marca de tiempo del evento devuelta en formato ISO 8601 con el desfase UTC incluido
para indicar la zona horaria local del evento.
    Example: 2025-09-15T09:22:36-05:00