Skip to main content
GET
/
v1
/
delays
Flight Delays
curl --request GET \
  --url https://api.flystack.dev/v1/delays \
  --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",
    "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",
    "status": "scheduled",
    "duration": 359,
    "delayed": 137
  }
]
Beta: This endpoint reflects live delays for departing or arriving flights. Coverage may vary.
Real-time delay data helps you monitor disruption anywhere in the world, or focus on a specific airport/route. It’s especially useful for airport transfers, travel insurance, and delay compensation workflows.

​
Authentication

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

​
Query parameters

​
Required

​
delay
number
required
Minimum delay (in minutes). Must be greater than 30.
​
type
string
required
Flight type:
  • departures
  • arrivals

​
Optional filters

​
dep_iata
string
Filter by departure airport IATA code.
​
dep_icao
string
Filter by departure airport ICAO code.
​
arr_iata
string
Filter by arrival airport IATA code.
​
arr_icao
string
Filter by arrival airport ICAO code.
​
airline_icao
string
Filter by airline ICAO code.
​
airline_iata
string
Filter by airline IATA code.
​
flight_icao
string
Filter by flight ICAO code-number.
​
flight_iata
string
Filter by flight IATA code-number.
​
flight_number
string
Filter by flight number only.

​
Response shaping & pagination

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

​
Response

The endpoint returns a list of delayed flights.

​
Delay response fields

This response reuses the schedule-style fields (airline/flight codes, airports, terminals/gates, times). The key delay field is delayed.
[
  {
    "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",
    "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",
    "status": "scheduled",
    "duration": 359,
    "delayed": 137
  }
]

​
See also