Flight Schedules API

Discover how you can use real-time Flight Schedules API and airline schedules database to build your products.


The real-time flight schedule database reflects the current status of the departure and boarding queue.

At the moment, the Schedules API returns results up to 10 hours ahead at most.

Each departure or arrival airport displays these schedules in the lounges and terminal or gate areas.

Using Flight Schedules API, you can create your own timetable - in the app, on the site, in watches, bots, and wherever.

You can give users of your products the best service imaginable.

Just take a look at this simple flight schedules example.


Flight Schedules API Request:


                https://airlabs.co/api/v9/schedules?dep_iata=MIA&api_key={{params.api_key}}

Flight Schedules API Request Parameters:

Parameter Description
api_key required Your API Key from acccount dashboard.
dep_iata required Query by departure Airport IATA code.
dep_icao required Query by departure Airport ICAO code.
arr_iata required Query by arrival Airport IATA code.
arr_icao required Query by arrival Airport ICAO code.
airline_iata required Query by 1 IATA code or filter by many IATA codes (if querying by airport)
airline_icao required Query by 1 ICAO code or filter by many ICAO codes (if querying by airport)
flight_icao required Query by Flight ICAO code-number.
flight_iata required Query by Flight IATA code-number.
_fields optional Fields to return (comma separated, e.g.: airline_iata,flight_number)
limit optional Max 1000 if queried by airport, 200 if by airline, 50 for Free keys
offset optional Pagination offset for use with result limits (0+ until request.has_more)

Flight Schedule API Response:


              [{
                "airline_iata": "BA",
                "airline_icao": "BAW",
                "flight_iata": "BA6984",
                "flight_icao": "BAW6984",
                "flight_number": "6984",
                "cs_airline_iata": "AA",
                "cs_flight_number": "2421",
                "cs_flight_iata": "AA2421",
                "dep_iata": "MIA",
                "dep_icao": "KMIA",
                "dep_terminal": "C",
                "dep_gate": "E4",
                "dep_time": "2021-07-14 19:53",
                "dep_time_ts": 1626306780,
                "dep_time_utc": "2021-07-14 23:53",
                "dep_estimated": "2021-07-14 22:10",
                "dep_estimated_ts": 1626315000,
                "dep_estimated_utc": "2021-07-15 02:10",
                "dep_actual": "2021-07-14 22:10",
                "dep_actual_ts": 1626315000,
                "dep_actual_utc": "2021-07-15 02:10",
                "arr_iata": "SFO",
                "arr_icao": "KSFO",
                "arr_terminal": "1",
                "arr_gate": "B24",
                "arr_baggage": "1",
                "arr_time": "2021-07-14 22:52",
                "arr_time_ts": 1626328320,
                "arr_time_utc": "2021-07-15 05:52",
                "arr_estimated": "2021-07-15 01:09",
                "arr_estimated_ts": 1626336540,
                "arr_estimated_utc": "2021-07-15 08:09",
                "arr_actual": "2021-07-15 01:09",
                "arr_actual_ts": 1626336540,
                "arr_actual_utc": "2021-07-15 08:09",
                "status": "scheduled",
                "duration": 359,
                "delayed": 137,
                "dep_delayed": 137,
                "arr_delayed": 137
              }]


Flight Schedule Database response parameters:

Parameter Description
airline_iata Airline IATA code. Available in the Free plan.
airline_icao Airline ICAO code.
flight_iata Flight IATA code-number. Available in the Free plan.
flight_icao Flight ICAO code-number.
flight_number Flight number only. Available in the Free plan.
cs_airline_iata Codeshared airline IATA code.
cs_flight_iata Codeshared flight IATA code-number.
cs_flight_number Codeshared flight number.
dep_iata Departure airport IATA code. Available in the Free plan.
dep_icao Departure airport ICAO code.
dep_terminal Estimated departure terminal.
dep_gate Estimated departure gate.
dep_time Departure time in the airport time zone. Available in the Free plan.
dep_time_ts Departure UNIX timestamp.
dep_time_utc Departure time in UTC time zone.
dep_estimated Updated departure time in the airport time zone.
dep_estimated_ts Updated departure UNIX timestamp.
dep_estimated_utc Updated departure time in UTC time zone.
dep_actual Actual departure time in the airport time zone.
dep_actual_ts Actual departure UNIX timestamp.
dep_actual_utc Actual departure time in UTC time zone.
arr_iata Arrival airport IATA code. Available in the Free plan.
arr_icao Arrival airport ICAO code.
arr_terminal Estimated arrival terminal.
arr_gate Estimated arrival gate.
arr_baggage Arrival baggage claim carousel number.
arr_time Arrival time in the airport time zone. Available in the Free plan.
arr_time_ts Arrival UNIX timestamp.
arr_time_utc Arrival time in UTC time zone.
arr_estimated Updated arrival time in the airport time zone.
arr_estimated_ts Updated arrival UNIX timestamp.
arr_estimated_utc Updated arrival time in UTC time zone.
arr_actual Actual arrival time in the airport time zone.
arr_actual_ts Actual arrival UNIX timestamp.
arr_actual_utc Actual arrival time in UTC time zone.
duration Estimated flight time (in minutes).
delayed (deprecated) Estimated flight delay time (in minutes).
dep_delayed Estimated time of flight departure delay (in minutes).
arr_delayed Estimated time of flight arrival delay (in minutes).
status Flight status - scheduled, cancelled, active, landed.

By the way, you may also be interested in the grid.js library.

       Github    Reddit

See also

Aircraft Fleets Database API
Real-Time Flights API
Global Aviation Routes Database API
Airlines Database API
Airports Database API


Questions? Contact us.