> For the complete documentation index, see [llms.txt](https://docs.shippify.co/developers/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.shippify.co/developers/shippify-api/rutas/obtener-informacion-de-una-ruta.md).

# 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"}}]}}}}
```