Skip to main content
GET
/
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