Flight Schedules API

GET /timetable

Real-time flight schedule, status, flight details and delay data in the form of departure and arrival timetables of airports worldwide. They aren't strictly required, but for the most accurate results, it's strongly recommended to include both iataCode and type parameters in your requests.

Request

Base URL
https://aviation-edge.com/v2/public
Auth
API key in query parameter key
TypeScript
https://skmtc.dev/aviation-edge/apis/aviation-edge-flight-schedules-api/docs/timetable/get.ts
A function with typed inputs. Its response is checked against the schema.

Query parameters

keystring required

Example:your-api-key-here

Your Aviation Edge API key (sent to your email)

iataCodestring

IATA code of the airport you want to request Example: https://aviation-edge.com/v2/public/timetable?key=[API_KEY]&iataCode=JFK&type=departure

type'departure' | 'arrival'

Airport schedule type - can be departure or arrival Example: https://aviation-edge.com/v2/public/timetable?key=[API_KEY]&iataCode=DXB&type=arrival

**Status of the flight - can be landed, scheduled, cancelled, active, incident, diverted, redirected, unknown ** Example: https://aviation-edge.com/v2/public/timetable?key=[API_KEY]&iataCode=DXB&type=arrival&status=landed

dep_terminalstring

Terminal at the departure airport (e.g., 1, 2, A, B) Example: https://aviation-edge.com/v2/public/timetable?key=[API_KEY]&iataCode=LHR&type=arrival&dep_terminal=4

dep_delayinteger

**Departure delay in minutes (e.g., 10, 20, 45) It is not possible to set a delay range ** Example: https://aviation-edge.com/v2/public/timetable?key=[API_KEY]&iataCode=CDG&dep_delay=7&type=arrival

dep_schTimestring date-time

Scheduled departure time of the flight Format: YYYY-MM-DDT00:00:00.000 Example: https://aviation-edge.com/v2/public/timetable?key=[API_KEY]&iataCode=CDG&dep_schTime=2025-06-07T05:00:00.000&type=arrival

dep_estTimestring date-time

Estimated departure time of the flight Format: YYYY-MM-DDT00:00:00.000 Example: https://aviation-edge.com/v2/public/timetable?key=[API_KEY]&iataCode=CDG&dep_estTime=2025-05-15T10:00:00.000&type=arrival

dep_actTimestring date-time

**Actual departure time of the flight Format: YYYY-MM-DDT00:00:00.000 ** Example: https://aviation-edge.com/v2/public/timetable?key=[API_KEY]&iataCode=CDG&dep_actTime=2025-05-15T10:00:00.000&type=arrival

dep_estRunwaystring date-time

**Estimated runway time for the departure Format: YYYY-MM-DDT00:00:00.000 ** Example: https://aviation-edge.com/v2/public/timetable?key=[API_KEY]&iataCode=CDG&dep_estRunway=2025-05-15T10:00:00.000&type=arrival

dep_actRunwaystring date-time

Actual runway time for the arrival Format: YYYY-MM-DDT00:00:00.000 Example: https://aviation-edge.com/v2/public/timetable?key=[API_KEY]&iataCode=CDG&dep_actRunway=2025-05-15T10:00:00.000&type=arrival

arr_terminalstring

The terminal at the arrival airport (e.g., 1, 2, A, B) Example: https://aviation-edge.com/v2/public/timetable?key=[API_KEY]&iataCode=CDG&arr_terminal=1&type=arrival

arr_delayinteger

Arrival delay in minutes (e.g., 10, 20, 45) It is not possible to set a delay range Example: https://aviation-edge.com/v2/public/timetable?key=[API_KEY]&iataCode=CDG&type=departure&arr_delay=4

arr_schTimestring date-time

Schedules arrival time of the flight Format: YYYY-MM-DDT00:00:00.000 Example: https://aviation-edge.com/v2/public/timetable?key=[API_KEY]&iataCode=CDG&type=departure&arr_schTime=2025-06-13T10:00:00.000

arr_estTimestring date-time

**Estimated arrival time of the flight Format: YYYY-MM-DDT00:00:00.000 ** Example: https://aviation-edge.com/v2/public/timetable?key=[API_KEY]&iataCode=BCN&type=departure&arr_estTime=2025-06-13T17:34:00.000

arr_actTimestring date-time

Actual arrival time of the flight Format: YYYY-MM-DDT00:00:00.000 Example: https://aviation-edge.com/v2/public/timetable?key=[API_KEY]&iataCode=CDG&arr_actTime=2025-05-15T10:00:00.000&type=departure

arr_estRunwaystring date-time

Estimated runway time for the arrival Format: YYYY-MM-DDT00:00:00.000 Example: https://aviation-edge.com/v2/public/timetable?key=[API_KEY]&iataCode=CDG&arr_estRunway=2025-05-15T14:53:00.000&type=departure

arr_actRunwaystring date-time

Actual runway time for the arrival Format: YYYY-MM-DDT00:00:00.000 Example: https://aviation-edge.com/v2/public/timetable?key=[API_KEY]&iataCode=CDG&type=departure&arr_actRunway=2025-06-15T10:10:00.000

airline_namestring

Name of the airline (e.g., Air France, American Airlines, Delta Air Lines) Use %20 for spaces (e.g., air%20france, american%20airlines, delta%20air%20lines) Example: https://aviation-edge.com/v2/public/timetable?key=[API_KEY]&airline_name=american%20airlines&type=arrival

airline_iatastring

IATA code of the airline Example: https://aviation-edge.com/v2/public/timetable?key=[API_KEY]&iataCode=LHR&airline_iata=GB&type=arrival

airline_icaostring

ICAO code of the airline Example: https://aviation-edge.com/v2/public/timetable?key=[API_KEY]&iataCode=LHR&airline_icao=EIN&type=departure

flight_numstring

Flight number without the airline code (e.g., 171, 1234, 98) Example: https://aviation-edge.com/v2/public/timetable?key=[API_KEY]&iataCode=LHR&flight_num=171&type=departure

flight_iatastring

Flight number in IATA format Example: https://aviation-edge.com/v2/public/timetable?key=[API_KEY]&flight_iata=AA171&type=arrival

flight_icaostring

Flight number in ICAO format Example: https://aviation-edge.com/v2/public/timetable?key=[API_KEY]&flight_icao=AAL171&type=departure

langstring

Get a translated output for airport names, city names and country names into 43 different languages by using the 2-digit language code. See details below. Example: https://aviation-edge.com/v2/public/timetable?key=[API_KEY]&iataCode=LHR&type=arrival&lang=fr

Response

Successful operation

statusstring

typestring

Example response

{
  "airline": {
    "iataCode": "NZ",
    "icaoCode": "ANZ",
    "name": "Air New Zealand"
  },
  "arrival": {
    "actualRunway": "2024-06-14T23:02:00.000",
    "actualTime": "2024-06-14T23:02:00.000",
    "baggage": "C12",
    "delay": 48,
    "estimatedRunway": "2024-06-14T23:02:00.000",
    "estimatedTime": "2024-06-14T23:02:00.000",
    "gate": "35",
    "iataCode": "IAH",
    "icaoCode": "KIAH",
    "scheduledTime": "2024-06-14T22:14:00.000",
    "terminal": "C"
  },
  "codeshared": {
    "airline": {
      "iataCode": "ua",
      "icaoCode": "ual",
      "name": "united airlines"
    },
    "flight": {
      "iataNumber": "ua1610",
      "icaoNumber": "ual1610",
      "number": "1610"
    }
  },
  "departure": {
    "actualRunway": "2024-06-14T21:03:00.000",
    "actualTime": "2024-06-14T21:03:00.000",
    "baggage": "6",
    "delay": 95,
    "estimatedRunway": "2024-06-14T21:03:00.000",
    "estimatedTime": "2024-06-14T19:29:00.000",
    "gate": "27",
    "iataCode": "EWR",
    "icaoCode": "KEWR",
    "scheduledTime": "2024-06-14T19:29:00.000",
    "terminal": "A"
  },
  "flight": {
    "iataNumber": "NZ6603",
    "icaoNumber": "ANZ6603",
    "number": "6603"
  },
  "status": "landed",
  "type": "arrival"
}

Changes

No recorded changes to this operation across all 1 revision of this API.