Skip to main content
GET
https://api.flystack.dev
/
v1
/
schedules
Flight Schedules
curl --request GET \
  --url https://api.flystack.dev/v1/schedules \
  --header 'x-api-key: <x-api-key>'
[
  {
    "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,
    "dep_delayed": 137,
    "arr_delayed": 137
  }
]
Build timetables and “what’s next” experiences using live flight schedules. Schedules are ideal for airport-style boards, lounge/terminal displays, travel assistants, bots, widgets, and any product that needs the latest departure/arrival queue.
Schedules typically return results up to ~10 hours ahead (coverage may vary).

Authentication

x-api-key
string
required
Your FlyStack API token. You can create one from the dashboard (see Authentication).

Query parameters

You can query schedules by airport, airline, or specific flight codes.

Airport filters

dep_iata
string
Departure airport IATA code (e.g., MIA).
dep_icao
string
Departure airport ICAO code (e.g., KMIA).
arr_iata
string
Arrival airport IATA code (e.g., SFO).
arr_icao
string
Arrival airport ICAO code (e.g., KSFO).

Airline filters

airline_iata
string
Query by one airline IATA code, or provide multiple IATA codes when querying by airport (comma-separated).
airline_icao
string
Query by one airline ICAO code, or provide multiple ICAO codes when querying by airport (comma-separated).

Flight filters

flight_icao
string
Query by flight ICAO code-number (e.g., BAW6984).
flight_iata
string
Query by flight IATA code-number (e.g., BA6984).

Response shaping & pagination

_fields
string
Comma-separated list of fields to return (e.g., airline_iata,flight_number).
limit
number
Maximum number of results (limits may depend on your plan and query type).
offset
number
Pagination offset (0+). Use with limit when a response indicates there are more results.

Response

The endpoint returns a list of schedule entries.

Flight schedule response fields

[
  {
    "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,
    "dep_delayed": 137,
    "arr_delayed": 137
  }
]

See also