# Ver envíos y tracking
{% hint style="warning" %}
Los endpoints de búsqueda y obtención de envíos y tracking utilizan **rate limiting** :yellow\_circle:**Bajo**\
[Ver más sobre límites de requests](/envios/principios/limites-de-requests.md)
{% endhint %}
## Listar envíos
> Obtiene un listado paginado de envíos ordenados por fecha de creación descendente. Por defecto retorna los envíos de los últimos 30 días. Cada página contiene hasta 20 resultados.
```json
{"openapi":"3.0.0","info":{"title":"Zipnova Shipping API V2","version":"2.0.0"},"tags":[{"name":"Envíos","description":"Gestión de envíos y tracking"}],"servers":[{"url":"https://api.zipnova.com.ar/v2","description":"v2 API - Argentina (AR)"},{"url":"https://api.zipnova.cl/v2","description":"v2 API - Chile (CL)"},{"url":"https://api.zipnova.com.mx/v2","description":"v2 API - México (MX)"}],"security":[{"basicAuth":[]},{"bearerAuth":[]}],"components":{"securitySchemes":{"basicAuth":{"type":"http","description":"Autenticación básica HTTP utilizando token como nombre de usuario y secret como contraseña","scheme":"basic"},"bearerAuth":{"type":"http","description":"Token de autenticación Bearer OAuth para API V2","bearerFormat":"OAuth","scheme":"bearer"}},"schemas":{"ShipmentSummaryResource":{"title":"Resumen de envío","properties":{"id":{"description":"ID único del envío","type":"integer"},"external_id":{"description":"Identificador externo del envío (e.g. número de orden del cliente)","type":"string","nullable":true},"delivery_id":{"description":"Número de remito asignado por el transportista","type":"string","nullable":true},"created_at":{"description":"Fecha y hora de creación del envío (ISO 8601)","type":"string","format":"date-time"},"account_id":{"description":"ID de la cuenta propietaria del envío","type":"integer"},"parent_shipment_id":{"description":"ID del envío padre. Presente cuando este envío es una devolución o reenvío","type":"integer","nullable":true},"carrier_id":{"description":"ID del transportista asignado","type":"integer"},"service_type":{"description":"Código del tipo de servicio (e.g. standard, express, pickup_point)","type":"string"},"status":{"description":"Código de estado actual del envío (e.g. new, crossdock, delivered)","type":"string"},"status_name":{"description":"Nombre legible del estado actual","type":"string"},"tracking":{"description":"URL de seguimiento público del envío en la plataforma","type":"string","nullable":true},"tracking_external":{"description":"URL de seguimiento en el sitio web del transportista","type":"string","nullable":true},"destination":{"description":"Datos resumidos del destinatario","properties":{"name":{"description":"Nombre del destinatario","type":"string"},"city":{"description":"Ciudad de destino","type":"string"},"state":{"description":"Provincia o estado de destino","type":"string"},"zipcode":{"description":"Código postal de destino","type":"string","nullable":true}},"type":"object"},"origin":{"description":"Datos resumidos del origen del envío","properties":{"id":{"description":"ID del origen en el catálogo de direcciones (address_book_id)","type":"integer"},"name":{"description":"Nombre del punto de origen","type":"string"},"city":{"description":"Ciudad de origen","type":"string"},"state":{"description":"Provincia o estado de origen","type":"string"},"zipcode":{"description":"Código postal de origen","type":"string","nullable":true}},"type":"object"},"declared_value":{"description":"Valor declarado del contenido del envío en la moneda local","type":"number","format":"float"},"price":{"description":"Costo del envío sin impuestos","type":"number","format":"float"},"price_incl_tax":{"description":"Costo del envío con impuestos incluidos","type":"number","format":"float"},"total_weight":{"description":"Peso total del envío en gramos","type":"integer"},"total_volume":{"description":"Volumen total del envío en centímetros cúbicos (cm³)","type":"integer"},"total_packages":{"description":"Cantidad de paquetes del envío","type":"integer"}},"type":"object"}}},"paths":{"/shipments":{"get":{"tags":["Envíos"],"summary":"Listar envíos","description":"Obtiene un listado paginado de envíos ordenados por fecha de creación descendente. Por defecto retorna los envíos de los últimos 30 días. Cada página contiene hasta 20 resultados.","operationId":"a39b94b724f18014c30208fb5f20c160","parameters":[{"name":"account_id","in":"query","description":"Filtrar por ID de cuenta. Solo pueden consultar cuentas a las que tienen acceso.","required":false,"schema":{"type":"integer"}},{"name":"carrier_id","in":"query","description":"Filtrar por ID de transportista","required":false,"schema":{"type":"integer"}},{"name":"external_id","in":"query","description":"Filtrar por ID externo del envío (búsqueda exacta)","required":false,"schema":{"type":"string"}},{"name":"service_type","in":"query","description":"Filtrar por código de tipo de servicio (e.g. standard_delivery, pickup_point)","required":false,"schema":{"type":"string"}},{"name":"status","in":"query","description":"Filtrar por código de estado (e.g. new, shipped, delivered, cancelled)","required":false,"schema":{"type":"string"}},{"name":"order_id","in":"query","description":"Filtrar por ID de pedido del canal de venta (e.g. número de orden de MercadoLibre o Shopify)","required":false,"schema":{"type":"string"}},{"name":"parent_shipment_id","in":"query","description":"Filtrar envíos relacionados (devoluciones o reenvíos) a partir del ID del envío padre","required":false,"schema":{"type":"integer"}},{"name":"origin_id","in":"query","description":"Filtrar por ID del origen en el catálogo de direcciones (address id)","required":false,"schema":{"type":"integer"}},{"name":"from","in":"query","description":"Fecha de inicio del rango de creación (YYYY-MM-DD). Por defecto: 30 días atrás.","required":false,"schema":{"type":"string","format":"date"}},{"name":"to","in":"query","description":"Fecha de fin del rango de creación (YYYY-MM-DD, inclusive)","required":false,"schema":{"type":"string","format":"date"}}],"responses":{"200":{"description":"Lista paginada de envíos","content":{"application/json":{"schema":{"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/ShipmentSummaryResource"}},"links":{"description":"URLs de navegación de paginación","properties":{"first":{"type":"string","nullable":true},"last":{"type":"string","nullable":true},"prev":{"type":"string","nullable":true},"next":{"type":"string","nullable":true}},"type":"object"},"meta":{"description":"Metadatos de la paginación","properties":{"current_page":{"type":"integer"},"from":{"type":"integer","nullable":true},"last_page":{"type":"integer"},"per_page":{"type":"integer"},"to":{"type":"integer","nullable":true},"total":{"type":"integer"}},"type":"object"}},"type":"object"}}}}}}}}}
```
## Obtener envío
> Obtiene el detalle completo de un envío específico, incluyendo paquetes, ítems, destino, origen, tiempos de entrega y envíos relacionados.
```json
{"openapi":"3.0.0","info":{"title":"Zipnova Shipping API V2","version":"2.0.0"},"tags":[{"name":"Envíos","description":"Gestión de envíos y tracking"}],"servers":[{"url":"https://api.zipnova.com.ar/v2","description":"v2 API - Argentina (AR)"},{"url":"https://api.zipnova.cl/v2","description":"v2 API - Chile (CL)"},{"url":"https://api.zipnova.com.mx/v2","description":"v2 API - México (MX)"}],"security":[{"basicAuth":[]},{"bearerAuth":[]}],"components":{"securitySchemes":{"basicAuth":{"type":"http","description":"Autenticación básica HTTP utilizando token como nombre de usuario y secret como contraseña","scheme":"basic"},"bearerAuth":{"type":"http","description":"Token de autenticación Bearer OAuth para API V2","bearerFormat":"OAuth","scheme":"bearer"}},"schemas":{"ShipmentApiResource":{"title":"Envío","properties":{"id":{"description":"ID único del envío","type":"integer"},"external_id":{"description":"Identificador externo del envío (e.g. número de orden del cliente)","type":"string","nullable":true},"delivery_id":{"description":"Número de remito asignado por el transportista","type":"string","nullable":true},"carrier_tracking_id":{"description":"Identificador de seguimiento público del transportista","type":"string","nullable":true},"carrier_tracking_id_alt":{"description":"Identificador de seguimiento alternativo del transportista","type":"string","nullable":true},"created_at":{"description":"Fecha y hora de creación del envío (ISO 8601)","type":"string","format":"date-time"},"delivery_time":{"description":"Tiempos estimados de entrega","properties":{"estimated_delivery":{"description":"Fecha estimada de entrega al destinatario (ISO 8601)","type":"string","format":"date-time","nullable":true},"dropoff_deadline_at":{"description":"Fecha límite para ingresar el envío al transportista (ISO 8601)","type":"string","format":"date-time","nullable":true},"times":{"description":"Desglose de tiempos en días hábiles. Indicados en formato ISO8601 para duraciones de tiempo.","properties":{"preparation":{"description":"Días de preparación antes de despacho","type":"string"},"crossdocking":{"description":"Días de tránsito por crossdocking","type":"string"},"carrier":{"description":"Días de tránsito del transportista","type":"string"},"total":{"description":"Tiempo total estimado en días hábiles","type":"string"}},"type":"object"}},"type":"object"},"account_id":{"description":"ID de la cuenta propietaria del envío","type":"integer"},"parent_shipment_id":{"description":"ID del envío padre. Presente cuando este envío es una devolución o reenvío","type":"integer","nullable":true},"logistic_type":{"description":"Tipo de logística del envío (e.g. crossdock, carrier_dropoff, xd_dropoff, self_service)","type":"string"},"service_type":{"description":"Código del tipo de servicio (e.g. standard, express, pickup_point)","type":"string"},"carrier":{"description":"Transportista asignado al envío","properties":{"id":{"description":"ID del transportista","type":"integer"},"name":{"description":"Nombre del transportista","type":"string"},"logo":{"description":"URL del logotipo del transportista","type":"string","nullable":true}},"type":"object"},"status":{"description":"Código de estado actual del envío (e.g. new, in_transit, delivered)","type":"string"},"status_name":{"description":"Nombre legible del estado actual","type":"string"},"tracking":{"description":"URL de seguimiento público del envío en la plataforma","type":"string","nullable":true},"tracking_external":{"description":"URL de seguimiento en el sitio web del transportista","type":"string","nullable":true},"return_instructions":{"description":"URL con instrucciones de devolución. Solo presente en envíos de tipo reverse logistics","type":"string","nullable":true},"destination":{"description":"Datos completos del destinatario","properties":{"name":{"description":"Nombre completo del destinatario","type":"string"},"document":{"description":"Documento de identidad del destinatario","type":"string"},"street":{"description":"Calle del destinatario","type":"string","nullable":true},"street_number":{"description":"Número de calle del destinatario","type":"string","nullable":true},"street_extras":{"description":"Piso, departamento u otras indicaciones adicionales","type":"string","nullable":true},"city":{"description":"Ciudad de destino","type":"string"},"state":{"description":"Provincia o estado de destino","type":"string"},"zipcode":{"description":"Código postal de destino","type":"string","nullable":true},"phone":{"description":"Teléfono de contacto del destinatario","type":"string"},"email":{"description":"Email de contacto del destinatario","type":"string","format":"email"},"pickup_point":{"description":"Datos del punto de retiro. Solo presente cuando service_type es pickup_point","properties":{"id":{"description":"ID del punto de retiro","type":"integer"},"name":{"description":"Nombre del punto de retiro","type":"string"},"geolocation":{"properties":{"lat":{"type":"number","format":"float"},"lng":{"type":"number","format":"float"}},"type":"object"}},"type":"object","nullable":true}},"type":"object"},"origin":{"description":"Datos completos del origen del envío","properties":{"id":{"description":"ID del origen en el catálogo de direcciones (address_book_id)","type":"integer"},"name":{"description":"Nombre del punto de origen","type":"string"},"document":{"description":"Documento de identidad del remitente","type":"string","nullable":true},"street":{"description":"Calle de origen","type":"string"},"street_number":{"description":"Número de calle de origen","type":"string"},"street_extras":{"description":"Información adicional de la dirección de origen","type":"string","nullable":true},"city":{"description":"Ciudad de origen","type":"string"},"state":{"description":"Provincia o estado de origen","type":"string"},"zipcode":{"description":"Código postal de origen","type":"string","nullable":true},"phone":{"description":"Teléfono de contacto del origen","type":"string"},"email":{"description":"Email de contacto del origen","type":"string","format":"email"},"is_dropshipping":{"description":"Indica si el envío parte desde un proveedor de dropshipping","type":"boolean"},"supplier":{"description":"Datos del proveedor dropshipping. Solo presente cuando is_dropshipping es true","properties":{"name":{"description":"Nombre del proveedor","type":"string","nullable":true}},"type":"object","nullable":true}},"type":"object"},"declared_value":{"description":"Valor declarado del contenido del envío en la moneda local","type":"number","format":"float"},"price":{"description":"Costo del envío sin impuestos","type":"number","format":"float"},"price_incl_tax":{"description":"Costo del envío con impuestos incluidos","type":"number","format":"float"},"total_weight":{"description":"Peso total del envío en gramos","type":"integer"},"total_volume":{"description":"Volumen total del envío en centímetros cúbicos (cm³)","type":"integer"},"packages":{"description":"Lista de paquetes del envío","type":"array","items":{"properties":{"id":{"description":"ID del paquete","type":"integer"},"label_code":{"description":"Código de etiqueta del paquete","type":"string","nullable":true},"sku_id":{"description":"ID del SKU si el paquete corresponde a un único SKU","type":"integer","nullable":true},"weight":{"description":"Peso del paquete en gramos","type":"integer"},"height":{"description":"Alto del paquete en milímetros","type":"integer"},"width":{"description":"Ancho del paquete en milímetros","type":"integer"},"length":{"description":"Largo del paquete en milímetros","type":"integer"},"volume":{"description":"Volumen del paquete en cm³","type":"integer"},"description_1":{"description":"Primera línea de descripción del contenido","type":"string"},"description_2":{"description":"Segunda línea de descripción del contenido","type":"string","nullable":true},"description_3":{"description":"Tercera línea de descripción del contenido","type":"string","nullable":true},"classification":{"description":"Clasificación arancelaria del contenido","properties":{"id":{"type":"integer"},"name":{"type":"string"}},"type":"object"},"tax_class_code":{"description":"Código de clase impositiva del paquete","type":"string","nullable":true},"label_elements":{"description":"Elementos para renderizar en la etiqueta del paquete (códigos de barra, QR, etc.). El contenido varía según el transportista. Presente solo cuando el envío tiene etiqueta generada.","type":"array","items":{"properties":{"id":{"description":"Identificador del elemento (e.g. zipnova_label_code, carrier_tracking_code, carrier_extra_code)","type":"string"},"type":{"description":"Tipo de elemento gráfico","type":"string","enum":["barcode","qrcode"]},"format":{"description":"Formato del código de barras. Solo presente cuando type es barcode","type":"string","nullable":true},"value":{"description":"Valor a codificar en el elemento gráfico","type":"string"}},"type":"object"},"nullable":true},"container":{"description":"Caja o contenedor predefinido. Solo presente si el paquete usa un contenedor guardado","properties":{"id":{"type":"integer"},"description":{"type":"string"},"outer_width":{"description":"Ancho exterior en mm","type":"integer"},"outer_height":{"description":"Alto exterior en mm","type":"integer"},"outer_length":{"description":"Largo exterior en mm","type":"integer"},"inner_width":{"description":"Ancho interior en mm","type":"integer"},"inner_length":{"description":"Largo interior en mm","type":"integer"},"inner_height":{"description":"Alto interior en mm","type":"integer"},"max_weight":{"description":"Peso máximo soportado en gramos","type":"integer"},"empty_weight":{"description":"Peso vacío del contenedor en gramos","type":"integer"}},"type":"object","nullable":true},"items":{"description":"Ítems individuales dentro del paquete","type":"array","items":{"properties":{"id":{"type":"integer"},"sku":{"description":"Datos del SKU vinculado. Los campos internal_sku, name y barcode solo están presentes si el ítem tiene un SKU registrado","properties":{"sku":{"description":"Código SKU","type":"string","nullable":true},"sku_id":{"description":"ID del SKU","type":"integer","nullable":true},"internal_sku":{"description":"SKU interno","type":"string","nullable":true},"name":{"description":"Nombre del producto","type":"string","nullable":true},"barcode":{"description":"Código de barras","type":"string","nullable":true}},"type":"object"},"description":{"description":"Descripción del ítem","type":"string"},"tax_class_code":{"description":"Código de clase impositiva del ítem","type":"string","nullable":true},"must_keep_vertical":{"description":"Indica si el ítem debe mantenerse vertical durante el transporte","type":"boolean"},"weight":{"description":"Peso en gramos","type":"integer"},"width":{"description":"Ancho en mm","type":"integer"},"length":{"description":"Largo en mm","type":"integer"},"height":{"description":"Alto en mm","type":"integer"},"pos_x":{"description":"Posición X dentro del contenedor (mm)","type":"integer","nullable":true},"pos_y":{"description":"Posición Y dentro del contenedor (mm)","type":"integer","nullable":true},"pos_z":{"description":"Posición Z dentro del contenedor (mm)","type":"integer","nullable":true}},"type":"object"}}},"type":"object"}},"tags":{"description":"Etiquetas asociadas al envío","type":"array","items":{"type":"string"}},"related_shipments":{"description":"Envíos relacionados (padre, devoluciones, reenvíos)","type":"array","items":{"properties":{"type":{"description":"Rol del envío relacionado","type":"string","enum":["parent","child"]},"relationship":{"description":"Tipo de relación entre los envíos","type":"string","enum":["copy","return","reshipped"]},"shipment_id":{"description":"ID del envío relacionado","type":"integer"}},"type":"object"}},"source":{"description":"Fuente u origen de creación del envío (e.g. nombre del canal o integración)","type":"string","nullable":true},"marketplace":{"description":"Marketplace asociado al envío. Presente solo si el envío proviene de un marketplace","properties":{"code":{"description":"Código del marketplace","type":"string"},"name":{"description":"Nombre del marketplace","type":"string"}},"type":"object","nullable":true},"order":{"description":"Pedido del canal de venta asociado al envío. Presente solo si el envío tiene un orden vinculado","properties":{"id":{"description":"ID interno del pedido","type":"integer"},"channel":{"description":"Canal de venta (e.g. meli, tiendanube, shopify, vtex)","type":"string"},"channel_created_at":{"description":"Fecha de creación del pedido en el canal (ISO 8601)","type":"string","format":"date-time"},"channel_relations":{"description":"IDs del pedido en el canal de venta (orden, paquete, envío del canal)","type":"array","items":{"properties":{"type":{"type":"string","enum":["order","pack","shipment"]},"id":{"description":"ID del recurso en el canal"}},"type":"object"},"nullable":true}},"type":"object","nullable":true},"fulfillment_order":{"description":"Orden de fulfillment asociada al envío. Presente solo si el envío está vinculado a un proceso de fulfillment","properties":{"id":{"type":"integer"},"status_id":{"description":"ID del estado de la orden de fulfillment","type":"integer"},"external_id":{"description":"ID externo de la orden de fulfillment","type":"string","nullable":true},"items":{"type":"array","items":{"properties":{"sku_id":{"type":"integer"},"qty":{"description":"Cantidad de unidades","type":"integer"},"lot_numbers":{"description":"Números de lote","type":"array","items":{"type":"string"},"nullable":true},"serial_numbers":{"description":"Números de serie","type":"array","items":{"type":"string"},"nullable":true}},"type":"object"}}},"type":"object","nullable":true}},"type":"object"}}},"paths":{"/shipments/{shipment}":{"get":{"tags":["Envíos"],"summary":"Obtener envío","description":"Obtiene el detalle completo de un envío específico, incluyendo paquetes, ítems, destino, origen, tiempos de entrega y envíos relacionados.","operationId":"4121f6dedbfe29b8883737e74b1c5008","parameters":[{"name":"shipment","in":"path","description":"ID del envío","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Detalle del envío","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShipmentApiResource"}}}},"403":{"description":"Sin acceso a este envío"},"404":{"description":"Envío no encontrado"}}}}}}
```
## Puntos de entrega disponibles
> Obtiene los puntos de entrega (dropoff) disponibles para un envío con logística carrier\_dropoff o xd\_dropoff. Se puede filtrar por código postal o por ciudad y provincia/estado. Sin filtros, retorna las sucursales más cercanas al origen del envío.
```json
{"openapi":"3.0.0","info":{"title":"Zipnova Shipping API V2","version":"2.0.0"},"tags":[{"name":"Envíos","description":"Gestión de envíos y tracking"}],"servers":[{"url":"https://api.zipnova.com.ar/v2","description":"v2 API - Argentina (AR)"},{"url":"https://api.zipnova.cl/v2","description":"v2 API - Chile (CL)"},{"url":"https://api.zipnova.com.mx/v2","description":"v2 API - México (MX)"}],"security":[{"basicAuth":[]},{"bearerAuth":[]}],"components":{"securitySchemes":{"basicAuth":{"type":"http","description":"Autenticación básica HTTP utilizando token como nombre de usuario y secret como contraseña","scheme":"basic"},"bearerAuth":{"type":"http","description":"Token de autenticación Bearer OAuth para API V2","bearerFormat":"OAuth","scheme":"bearer"}}},"paths":{"/shipments/{shipment}/dropoff_locations":{"get":{"tags":["Envíos"],"summary":"Puntos de entrega disponibles","description":"Obtiene los puntos de entrega (dropoff) disponibles para un envío con logística carrier_dropoff o xd_dropoff. Se puede filtrar por código postal o por ciudad y provincia/estado. Sin filtros, retorna las sucursales más cercanas al origen del envío.","operationId":"aa248dc7b6c83e2b37464ae6df710a7a","parameters":[{"name":"shipment","in":"path","description":"ID del envío","required":true,"schema":{"type":"integer"}},{"name":"zipcode","in":"query","description":"Código postal para buscar sucursales cercanas. No usar junto con city/state","required":false,"schema":{"type":"string"}},{"name":"city","in":"query","description":"Ciudad para buscar sucursales. Usar junto con state","required":false,"schema":{"type":"string"}},{"name":"state","in":"query","description":"Provincia o estado para buscar sucursales. Usar junto con city","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Lista de puntos de entrega disponibles","content":{"application/json":{"schema":{"properties":{"data":{"type":"array","items":{"properties":{"id":{"description":"ID del punto de entrega","type":"integer"},"name":{"description":"Nombre de la sucursal","type":"string"},"address":{"description":"Dirección de la sucursal","type":"string"},"city":{"description":"Ciudad","type":"string"},"state":{"description":"Provincia o estado","type":"string"},"zipcode":{"description":"Código postal","type":"string","nullable":true},"lat":{"description":"Latitud geográfica","type":"number","format":"float","nullable":true},"lng":{"description":"Longitud geográfica","type":"number","format":"float","nullable":true}},"type":"object"}}},"type":"object"}}}},"400":{"description":"El envío no tiene logística de tipo carrier_dropoff o xd_dropoff"},"403":{"description":"Sin acceso a este envío"},"404":{"description":"Envío no encontrado"}}}}}}
```
## Historial de estados
> Obtiene el historial completo de cambios de estado de un envío, ordenado por defecto del más reciente al más antiguo.
```json
{"openapi":"3.0.0","info":{"title":"Zipnova Shipping API V2","version":"2.0.0"},"tags":[{"name":"Envíos","description":"Gestión de envíos y tracking"}],"servers":[{"url":"https://api.zipnova.com.ar/v2","description":"v2 API - Argentina (AR)"},{"url":"https://api.zipnova.cl/v2","description":"v2 API - Chile (CL)"},{"url":"https://api.zipnova.com.mx/v2","description":"v2 API - México (MX)"}],"security":[{"basicAuth":[]},{"bearerAuth":[]}],"components":{"securitySchemes":{"basicAuth":{"type":"http","description":"Autenticación básica HTTP utilizando token como nombre de usuario y secret como contraseña","scheme":"basic"},"bearerAuth":{"type":"http","description":"Token de autenticación Bearer OAuth para API V2","bearerFormat":"OAuth","scheme":"bearer"}}},"paths":{"/shipments/{shipment}/tracking":{"get":{"tags":["Envíos"],"summary":"Historial de estados","description":"Obtiene el historial completo de cambios de estado de un envío, ordenado por defecto del más reciente al más antiguo.","operationId":"3334eba0693418d2a1184b12dc72593d","parameters":[{"name":"shipment","in":"path","description":"ID del envío","required":true,"schema":{"type":"integer"}},{"name":"sort","in":"query","description":"Orden de los eventos. newest: del más reciente al más antiguo. oldest: cronológico","required":false,"schema":{"type":"string","default":"newest","enum":["newest","oldest"]}}],"responses":{"200":{"description":"Historial de estados del envío","content":{"application/json":{"schema":{"properties":{"data":{"type":"array","items":{"properties":{"occurred_at":{"description":"Fecha y hora efectiva del cambio de estado (ISO 8601)","type":"string","format":"date-time"},"created_at":{"description":"Fecha y hora de registración del cambio de estado (ISO 8601)","type":"string","format":"date-time"},"status":{"properties":{"code":{"description":"Código interno del estado","type":"string"},"name":{"description":"Nombre del estado","type":"string"},"visible_name":{"description":"Nombre visible al cliente final","type":"string"},"substatus":{"description":"Nombre del subestado, si aplica","type":"string","nullable":true}},"type":"object"}},"type":"object"}}},"type":"object"}}}},"403":{"description":"Sin acceso a este envío"},"404":{"description":"Envío no encontrado"}}}}}}
```
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.zipnova.com/envios/recursos-api/envios/ver-envios-y-tracking.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.