---
title: "Flights Service"
url: "https://kongair.kong-sales-engineering.com/apis/flights/versions/ed7e4136-fab1-43a6-9f89-2f3089d8f879"
---

# Flights Service

OpenAPI specification document.

```json
{"openapi":"3.0.0","info":{"description":"KongAir Flights service provides the scheduled flights for KongAir","version":"1.0.0","title":"Flights Service"},"servers":[{"url":"https://shared-services.kong-sales-engineering.com/kongair","description":"KongAir API Server"}],"paths":{"/flights":{"get":{"summary":"Get KongAir planned flights","description":"Returns all the scheduled flights for a given day\n","tags":["flight-data"],"operationId":"get-flights","parameters":[{"name":"date","in":"query","description":"Filter by date (defaults to current day)","required":false,"style":"form","schema":{"type":"string","format":"date"}}],"responses":{"200":{"description":"Successful respone with scheduled flights","headers":{"hostname":{"description":"The hostname of the machine fulfilling the request.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Flight"}},"examples":{"Example Flights List":{"value":"[\n   {\n     \"number\": \"KD924\",\n     \"route_id\": \"LHR-SFO\",\n     \"scheduled_departure\": \"2024-03-20T09:12:28Z\",\n     \"scheduled_arrival\": \"2024-03-20T19:12:28Z\"\n   },\n   {\n     \"number\": \"KD925\",\n     \"route_id\": \"SFO-LHR\",\n     \"scheduled_departure\": \"2024-03-21T09:12:28Z\",\n     \"scheduled_arrival\": \"2024-03-21T19:12:28Z\"\n   }\n]\n"}}}}}}}},"/flights/{flightNumber}":{"get":{"summary":"Get a specific flight by flight number","description":"Returns a specific flight given its flight number\n","tags":["flight-data"],"operationId":"get-flight-by-number","parameters":[{"name":"flightNumber","in":"path","description":"The flight number","required":true,"style":"simple","schema":{"type":"string","example":"KA0284"}}],"responses":{"200":{"description":"Successful response with the requested flight","headers":{"hostname":{"description":"The hostname of the machine fulfilling the request.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Flight"},"examples":{"Example Flight KD924":{"value":"{\n  \"number\": \"KD924\",\n  \"route_id\": \"LHR-SFO\",\n  \"scheduled_departure\": \"2024-03-20T09:12:28Z\",\n  \"scheduled_arrival\": \"2024-03-20T19:12:28Z\"\n}\n"}}}}},"404":{"description":"Flight not found","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}}}}},"/flights/{flightNumber}/details":{"get":{"summary":"Fetch more details about a flight","description":"Fetch more details about a flight","tags":["flight-data"],"operationId":"get-flight-details","parameters":[{"name":"flightNumber","in":"path","description":"The flight number","required":true,"style":"simple","schema":{"type":"string","example":"KA0284"}}],"responses":{"200":{"description":"Successful response with the requested flight details","headers":{"hostname":{"description":"The hostname of the machine fulfilling the request.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FlightDetails"}}}},"404":{"description":"Flight not found","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}}}}}},"components":{"schemas":{"Flight":{"type":"object","properties":{"number":{"type":"string"},"route_id":{"type":"string"},"scheduled_departure":{"type":"string","format":"date-time"},"scheduled_arrival":{"type":"string","format":"date-time"}},"required":["number","route_id","scheduled_departure","scheduled_arrival"]},"FlightDetails":{"type":"object","properties":{"flight_number":{"type":"string"},"in_flight_entertainment":{"type":"boolean"},"meal_options":{"type":"array","items":{"type":"string"}},"aircraft_type":{"type":"string"}},"required":["flight_number","in_flight_entertainment","mean_options","aircraft_type"]}},"securitySchemes":{"basicAuth":{"type":"http","scheme":"basic"}}},"security":[{"basicAuth":[]}]}
```