---
title: "Flights Service"
url: "https://dev.kong-air.com/apis/kong-air-flights-0/versions/c6e88dea-cb80-470b-b387-23f2bb41f1f0"
---

# Flights Service

OpenAPI specification document.

```json
{"components":{"schemas":{"Flight":{"properties":{"number":{"type":"string"},"route_id":{"type":"string"},"scheduled_arrival":{"format":"date-time","type":"string"},"scheduled_departure":{"format":"date-time","type":"string"}},"required":["number","route_id","scheduled_departure","scheduled_arrival"],"type":"object"},"FlightDetails":{"properties":{"aircraft_type":{"type":"string"},"flight_number":{"type":"string"},"in_flight_entertainment":{"type":"boolean"},"meal_options":{"items":{"type":"string"},"type":"array"}},"required":["flight_number","in_flight_entertainment","meal_options","aircraft_type"],"type":"object"}}},"info":{"description":"KongAir Flights service provides the scheduled flights for KongAir","title":"Flights Service","version":"0.2.0"},"openapi":"3.0.0","paths":{"/flights":{"get":{"description":"Returns all the scheduled flights for a given day\n","operationId":"get-flights","parameters":[{"description":"Filter by date (defaults to current day)","in":"query","name":"date","required":false,"schema":{"format":"date","type":"string"},"style":"form"}],"responses":{"200":{"content":{"application/json":{"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"}},"schema":{"items":{"$ref":"#/components/schemas/Flight"},"type":"array"}}},"description":"Successful respone with scheduled flights","headers":{"hostname":{"description":"The hostname of the machine fulfilling the request.","schema":{"type":"string"}}}}},"summary":"Get KongAir planned flights","tags":["flight-data"]}},"/flights/{flightNumber}":{"get":{"description":"Returns a specific flight given its flight number\n","operationId":"get-flight-by-number","parameters":[{"description":"The flight number","in":"path","name":"flightNumber","required":true,"schema":{"type":"string"},"style":"simple"}],"responses":{"200":{"content":{"application/json":{"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"}},"schema":{"$ref":"#/components/schemas/Flight"}}},"description":"Successful response with the requested flight","headers":{"hostname":{"description":"The hostname of the machine fulfilling the request.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"properties":{"message":{"type":"string"}},"type":"object"}}},"description":"Flight not found"}},"summary":"Get a specific flight by flight number","tags":["flight-data"]}},"/flights/{flightNumber}/details":{"get":{"description":"Fetch more details about a flight","operationId":"get-flight-details","parameters":[{"description":"The flight number","in":"path","name":"flightNumber","required":true,"schema":{"type":"string"},"style":"simple"}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FlightDetails"}}},"description":"Successful response with the requested flight details","headers":{"hostname":{"description":"The hostname of the machine fulfilling the request.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"properties":{"message":{"type":"string"}},"type":"object"}}},"description":"Flight not found"}},"summary":"Fetch more details about a flight","tags":["flight-data"]}}},"servers":[{"description":"KongAir API Server","url":"https://api.kong-air.com"}]}
```