---
title: "Routes Service"
url: "https://kongair.kong-sales-engineering.com/apis/routes/versions/edadc143-7d75-4546-a85e-7db8b18d9477"
---

# Routes Service

OpenAPI specification document.

```json
{"openapi":"3.0.0","info":{"description":"KongAir Routes service provides the registered routes KongAir flies between origin and destination airports","version":"1.0.0","title":"Routes Service"},"servers":[{"url":"https://shared-services.kong-sales-engineering.com/kongair","description":"KongAir API Server"}],"paths":{"/routes/{id}":{"get":{"summary":"Request a specific KongAir route by id (LHR-JFK)","description":"Returns a specific route from a given Route ID\n","tags":["flight-data"],"operationId":"get-route","parameters":[{"name":"id","in":"path","description":"String route ID","required":true,"schema":{"type":"string","example":"LHR-JFK"}}],"responses":{"200":{"description":"Successful response with the found Route","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Route"}}}},"404":{"description":"Route not found"}}}},"/routes":{"get":{"summary":"Request all the KongAir routes","description":"Returns all the routes KongAir is currently registered to fly.\nA Route is a pairing between origin and destination airport codes.\n","tags":["flight-data"],"operationId":"get-routes","parameters":[{"name":"origin","in":"query","description":"filter by origin","required":false,"style":"form","schema":{"type":"array","items":{"type":"string"}}}],"responses":{"200":{"description":"Successful response with the registered Routes","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Route"}},"examples":{"lhr-sfo":{"value":"[{\n   \"id\": \"LHR-SFO\",\n   \"origin\": \"LHR\",\n   \"destination\": \"SFO\",\n   \"avg_duration\": 660\n }]\n"}}}}}}}}},"components":{"schemas":{"Route":{"type":"object","properties":{"id":{"type":"string"},"origin":{"type":"string"},"destination":{"type":"string"},"avg_duration":{"type":"integer"}},"required":["id","origin","destination","avg_duration"]}},"securitySchemes":{"basicAuth":{"type":"http","scheme":"basic"}}},"security":[{"basicAuth":[]}]}
```