---
title: "GET /timetable"
method: GET
path: "/timetable"
tags: ["Flight Schedules API"]
---

# GET /timetable

`GET /timetable`

## Request

- Base URL: `https://aviation-edge.com/v2/public`
- URL: `https://aviation-edge.com/v2/public/timetable`
- 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)

Real-time flight schedule, status, flight details and delay data in the form of departure and arrival timetables of airports worldwide. <p>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.

## Query parameters

- `key` string, required
- `iataCode` string
- `type` 'departure' | 'arrival'
- `status` 'landed' | 'scheduled' | 'cancelled' | 'active' | 'incident' | 'diverted' | 'redirected' | 'unknown'
- `dep_terminal` string
- `dep_delay` integer
- `dep_schTime` string, date-time
- `dep_estTime` string, date-time
- `dep_actTime` string, date-time
- `dep_estRunway` string, date-time
- `dep_actRunway` string, date-time
- `arr_terminal` string
- `arr_delay` integer
- `arr_schTime` string, date-time
- `arr_estTime` string, date-time
- `arr_actTime` string, date-time
- `arr_estRunway` string, date-time
- `arr_actRunway` string, date-time
- `airline_name` string
- `airline_iata` string
- `airline_icao` string
- `flight_num` string
- `flight_iata` string
- `flight_icao` string
- `lang` string

## Response `200`

Successful operation

- ScheduleResponse
  - `airline` object
    - `iataCode` string
    - `icaoCode` string
    - `name` string
  - `arrival` object
    - `actualRunway` string, date-time
    - `actualTime` string, date-time
    - `baggage` string
    - `delay` integer
    - `estimatedRunway` string, date-time
    - `estimatedTime` string, date-time
    - `gate` string
    - `iataCode` string
    - `icaoCode` string
    - `scheduledTime` string, date-time
    - `terminal` string
  - `codeshared` object
    - `airline` object
      - `iataCode` string
      - `icaoCode` string
      - `name` string
    - `flight` object
      - `iataNumber` string
      - `icaoNumber` string
      - `number` string
  - `departure` object
    - `actualRunway` string, date-time
    - `actualTime` string, date-time
    - `baggage` string
    - `delay` integer
    - `estimatedRunway` string, date-time
    - `estimatedTime` string, date-time
    - `gate` string
    - `iataCode` string
    - `icaoCode` string
    - `scheduledTime` string, date-time
    - `terminal` string
  - `flight` object
    - `iataNumber` string
    - `icaoNumber` string
    - `number` string
  - `status` string
  - `type` string

---

[API](https://skmtc.dev/aviation-edge/apis/aviation-edge-flight-schedules-api.md) - [All operations](https://skmtc.dev/aviation-edge/apis/aviation-edge-flight-schedules-api/llms.txt) - [OpenAPI document](https://skmtc.dev/aviation-edge/apis/aviation-edge-flight-schedules-api/revisions/150efe34164d?raw)