# Obtener información de una ruta

## Consulta de ruta

> Recuperar datos de una ruta.

```json
{"openapi":"3.0.0","info":{"title":"API de Shippify","version":"1.0.0"},"servers":[{"url":"https://api.shippify.co","description":"Servidor de desarrollo"}],"security":[{"Basic_Auth":[]}],"components":{"securitySchemes":{"Basic_Auth":{"type":"http","scheme":"basic"}},"schemas":{"getRoute":{"successfullResponse":{"type":"object","description":"Información de la ruta consultada","properties":{"payload":{"type":"object","properties":{"route":{"type":"object","properties":{"id":{"type":"string","description":"Identificador de la ruta en shippify."},"city":{"type":"object","description":"Información de la ciudad donde se recolectan las entregas de la ruta","properties":{"id":{"type":"string","description":"Identificador de la ciudad en Shippify"},"name":{"type":"string","description":"Nombre de la ciudad"}}},"deliveries":{"type":"array","description":"Entregas pertenecientes a la ruta consultada","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador de la entrega en shippify"},"referenceId":{"type":"string","description":"Identificador externo de la entrega, puede ser el número de orden"},"state":{"description":"Código de estado de la entrega","type":"integer","minimum":1,"maximum":7},"status":{"type":"string","description":"Nombre del estado de la entrega"},"company":{"type":"object","description":"Información de la empresa de la entrega.","properties":{"id":{"description":"Identificador de la empresa.","type":"integer","minimum":1},"name":{"type":"string","description":"Nombre de la empresa."}}},"pickup":{"description":"Información de recolección","type":"object","properties":{"location":{"$ref":"#/components/schemas/delivery/location"},"timeWindow":{"type":"object","description":"Rango de fecha y hora para la recolección de la entrega.","properties":{"start":{"type":"string"},"end":{"type":"string"}}},"contact":{"$ref":"#/components/schemas/delivery/contact"}}},"dropoff":{"description":"Información de entrega","type":"object","properties":{"location":{"$ref":"#/components/schemas/delivery/location"},"timeWindow":{"type":"object","description":"Rango de fecha y hora para la entrega de los paquetes.","properties":{"start":{"type":"string"},"end":{"type":"string"}}},"contact":{"$ref":"#/components/schemas/delivery/contact"}}},"fare":{"type":"object","description":"Valores de la entrega","properties":{"service":{"type":"number","description":"Precio de la entrega"},"cash":{"type":"number","description":"Valor que el conductor debe cobrar al cliente al completar la entrega"},"currencyCode":{"type":"string","description":"Moneda de los valores de la entrega"}}},"packages":{"type":"object","description":"Paquetes de entrega","properties":{"capacity":{"description":"Capacidad de entrega","type":"integer","minimum":1,"maximum":5},"contents":{"description":"Información de paquetes.","type":"array","items":{"$ref":"#/components/schemas/delivery/package"}}}},"tags":{"description":"Nombres de etiquetas digitales","type":"array","items":{"description":"Nombre de la etiqueta digital","type":"string","maxLength":50}},"receiver":{"description":"Información de contacto del destinatario","$ref":"#/components/schemas/delivery/contact"},"chargedDistance":{"description":"Distancia cobrada","type":"number","minimum":0},"routeDistance":{"description":"Distancia de la ruta","type":"number","minimum":0},"deliveryType":{"description":"Tipo de entrega","type":"string","enum":["flex","express","slot"]},"jobId":{"description":"Identificador del proceso externo que se creó","type":"string"}}}},"status":{"type":"string","description":"Nombre del estado de la ruta"},"minimumCapacity":{"description":"Capacidad mínima de la ruta","type":"integer","minimum":1,"maximum":5},"stepIds":{"type":"array","description":"Pasos ordenados de la ruta.","items":{"type":"object","properties":{"deliveryId":{"description":"Identificador de entrega","type":"string"},"activityType":{"description":"Tipo de paso, puede ser recolección o entrega","type":"string"}}}}}}}}}}},"delivery":{"location":{"description":"Información de dirección de la ubicación de recolección de los paquetes de entrega.","type":"object","required":["address"],"properties":{"address":{"description":"Dirección de entrega.","type":"string"},"instructions":{"description":"Información extra sobre la dirección.","type":"string"},"lat":{"description":"Latitud del punto de recolección.","type":"string"},"lng":{"description":"Longitud del punto de recolección.","type":"string"}}},"contact":{"description":"Información de contacto de la persona responsable de entregar los paquetes en el almacén de recolección.","type":"object","required":["name","email"],"properties":{"name":{"description":"Nombre de la persona responsable.","type":"string"},"email":{"description":"Email de la persona responsable.","type":"string","format":"email"},"phonenumber":{"description":"Número de teléfono de la persona responsable.","type":"string"}}},"package":{"type":"object","required":["name","qty","size"],"properties":{"id":{"type":"string","description":"Identificador del paquete"},"name":{"type":"string","description":"Nombre del paquete"},"qty":{"description":"Número de paquetes en la orden (no el número de productos dentro del paquete).","type":"integer","minimum":0},"weight":{"description":"Peso unitario * cantidad en Kg","type":"number","minimum":0},"size":{"description":"Package size","type":"string","enum":["xs","s","m","l","xl"]},"price":{"description":"Precio unitario * cantidad en la moneda de la empresa","type":"number","minimum":0}}}},"Unauthenticated":{"properties":{"code":{"type":"string"},"message":{"type":"string"}},"type":"object"}}},"paths":{"/v1/routes/{id}":{"get":{"tags":["Routes"],"summary":"Consulta de ruta","description":"Recuperar datos de una ruta.","responses":{"200":{"description":"Operación exitosa","content":{"application/json":{"schema":{"$ref":"#/components/schemas/getRoute/successfullResponse"}}}},"401":{"description":"No autorizado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Unauthenticated"}}}}},"parameters":[{"name":"id","in":"path","description":"Identifier of the route to query.","required":true,"schema":{"type":"string"}}]}}}}
```


---

# 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.shippify.co/developers/shippify-api/rutas/obtener-informacion-de-una-ruta.md?ask=<question>
```

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.