---
title: "KongAir Route API"
url: "https://kongair.terwilligar.com/apis/kong-air-route-api-2-1-9/versions/f24fd3bb-3f0e-4e64-ad5f-4be59552336a"
---

# KongAir Route API

OpenAPI specification document.

```json
{"openapi":"3.0.3","info":{"title":"KongAir Route API","description":"API for querying the shortest flight route from origin to destination.","version":"1.0.0"},"servers":[{"url":"https://api.kongair.com/v1","description":"Production server"}],"paths":{"/routes":{"get":{"summary":"Get the shortest flight route","description":"Retrieve the shortest flight path from the origin airport to the destination airport.","parameters":[{"name":"origin","in":"query","required":true,"schema":{"type":"string","example":"JFK"},"description":"IATA code of the departure airport."},{"name":"destination","in":"query","required":true,"schema":{"type":"string","example":"LAX"},"description":"IATA code of the arrival airport."}],"responses":{"200":{"description":"Shortest flight route retrieved successfully.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Route"}}}}}}}},"components":{"schemas":{"Route":{"type":"object","properties":{"origin":{"type":"string","example":"JFK"},"destination":{"type":"string","example":"LAX"},"total_distance":{"type":"number","format":"float","example":3972,"description":"Total distance of the route in kilometers."},"total_duration":{"type":"string","example":"06:15:00","description":"Total estimated duration of the route in HH:MM:SS format."},"flights":{"type":"array","description":"List of flights in the shortest route.","items":{"$ref":"#/components/schemas/FlightSegment"}}}},"FlightSegment":{"type":"object","properties":{"flight_number":{"type":"string","example":"KA1234"},"airline":{"type":"string","example":"KongAir"},"departure_airport":{"type":"string","example":"JFK"},"arrival_airport":{"type":"string","example":"LAX"},"departure_time":{"type":"string","format":"date-time","example":"2025-06-01T08:30:00Z"},"arrival_time":{"type":"string","format":"date-time","example":"2025-06-01T11:30:00Z"},"duration":{"type":"string","example":"06:15:00","description":"Flight duration in HH:MM:SS format."}}}}}}
```