---
title: "Routes API"
url: "https://portal.kongair.dev/apis/routes-api/versions/c8d1f163-0e67-4266-a23d-b8d1f86ffded"
---

# Routes API

OpenAPI specification document.

```json
{"openapi":"3.0.0","info":{"description":"KongAir Routes API provides the registered routes KongAir flies between origin and destination airports. It uses standardized Origin-Destination (OD) pairs to identify routes. These pairs are represented as `XXX-YYY`, where `XXX` is the origin airport code and `YYY` is the destination airport code. Airline routes define the paths that airlines are registered to fly. These routes are essential for flight planning, scheduling, and regulatory compliance.","version":"0.3.0","title":"Routes API"},"servers":[{"url":"https://api.kongair.dev","description":"KongAir API Dev"}],"paths":{"/health":{"get":{"summary":"Health check endpoint for Kubernetes","description":"Endpoint that returns the service health status.","responses":{"200":{"description":"Service is healthy","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","example":"OK"}}}}}},"500":{"description":"Service is unhealthy","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","example":"unhealthy"}}}}}}}}},"/routes/{id}":{"get":{"summary":"Request a specific KongAir route by id","description":"Returns a specific route from a given Route ID","operationId":"get-route","parameters":[{"name":"id","in":"path","description":"String route ID","required":true,"schema":{"type":"string"}}],"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.","operationId":"get-routes","parameters":[{"name":"origin","in":"query","description":"Filter routes by origin airport code.  To filter by multiple origin airports, provide an array of airport codes (e.g., `origin=LHR&origin=JFK`).","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 }]"}}}}}}}}},"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"]}}}}
```