Download OpenAPI specification:Download
The Airport Delay Index APIs, part of the FlightStats APIs, returns a measure of the level of departure delays a airport is currently experiencing.
Cirium samples a relevant time range and considers the magnitude of delay, cancellations, and time of day to generate a normalized score.
A low index (0-1) indicates that departures are running relatively smoothly. A higher index (4-5) is indicative of significant delays and flight operations disruptions. The index is updated every 30 minutes.
Here's a sample of how the index can be mapped to severity
Airport Delay Index APIs answer questions such as:
Airport Delay Index APIs are standard APIs and included in our Commercial and Contract plans.
A breakdown of the available plans is available on Get evaluation account
FlightStats Airport Delays - Plots current airport delays on a map based on region
Cirium Airport Weather Impact - Dashboard of delay index and current weather conditions combined
Flight Status - Current flight information for flights about three days in advance of departure until about seven days after arrival
Weather - Weather has a significant impact on delay. FlightStats weather APIs include Metar and TAFs and Zone Forecast.
Weather (Laminar Data Hub) - Metar and TAFs are also available on Laminar Data Hub (in IWXXM format)
SIGMET (Laminar Data Hub) - Significant Meteorological Information weather advisories are available on Laminar Data Hub
Returns the current DelayIndex(es) for the given Airport(s)
format required | string Enum: "json" "jsonp" "xml" Example: json The data format returned in the response |
airports required | string Example: PDX,SEA+BLI One or more airport code(s) separated by punctuation characters |
classification | integer <int64> [ 1 .. 5 ] Example: classification=1 Airport classification filter, used to restrict results to larger airports where 1 is for the largest airports and 5 is for the smallest airports |
score | integer <int64> [ 0 .. 5 ] Example: score=1 Delay index normalized score filter, used to restrict results to airports experiencing delays. 5 is the maximum delay. |
codeType | string Enum: "FS" "IATA" "ICAO" Example: codeType=FS Airport code type. If not specified, the code searches in the order: IATA, ICAO, FS. |
extendedOptions | Array of strings Items Enum: "useHttpErrors" "includeNewFields" "useInlinedReferences" "languageCode:en" "languageCode:ar" "languageCode:de" "languageCode:es" "languageCode:fr" "languageCode:ja" "languageCode:ko" "languageCode:pt" "languageCode:zh" Extended options for modifying standard API behavior to fit special use cases |
Delay Index Response
Returns DelayIndexes for airports in the given Country
format required | string Enum: "json" "jsonp" "xml" Example: json The data format returned in the response |
country required | string <= 2 characters Example: US Country code |
classification | integer <int64> [ 1 .. 5 ] Example: classification=1 Airport classification filter, used to restrict results to larger airports where 1 is for the largest airports and 5 is for the smallest airports |
score | integer <int64> [ 0 .. 5 ] Example: score=5 Delay index normalized score filter, used to restrict results to airports experiencing delays. 5 is the maximum delay. |
extendedOptions | Array of strings Items Enum: "useHttpErrors" "includeNewFields" "useInlinedReferences" "languageCode:en" "languageCode:ar" "languageCode:de" "languageCode:es" "languageCode:fr" "languageCode:ja" "languageCode:ko" "languageCode:pt" "languageCode:zh" Extended options for modifying standard API behavior to fit special use cases |
Returns DelayIndexes for airports in the given Region
format required | string Enum: "json" "jsonp" "xml" Example: json The data format returned in the response |
region required | string Enum: "Africa" "Antarctica" "Asia" "Caribbean" "Central-America" "Europe" "Middle-East" "North-America" "Oceania" "South-America" Example: North-America Region |
classification | integer <int64> [ 1 .. 5 ] Example: classification=1 Airport classification filter, used to restrict results to larger airports where 1 is for the largest airports and 5 is for the smallest airports |
score | integer <int64> [ 0 .. 5 ] Example: score=5 Delay index normalized score filter, used to restrict results to airports experiencing delays. 5 is the maximum delay. |
extendedOptions | Array of strings Items Enum: "useHttpErrors" "includeNewFields" "useInlinedReferences" "languageCode:en" "languageCode:ar" "languageCode:de" "languageCode:es" "languageCode:fr" "languageCode:ja" "languageCode:ko" "languageCode:pt" "languageCode:zh" Extended options for modifying standard API behavior to fit special use cases |
Returns DelayIndexes for airports in the given State (US and Canada only)
format required | string Enum: "json" "jsonp" "xml" Example: json The data format returned in the response |
state required | string <= 2 characters Example: OR State code |
classification | integer <int64> [ 1 .. 5 ] Example: classification=1 Airport classification filter, used to restrict results to larger airports where 1 is for the largest airports and 5 is for the smallest airports |
score | integer <int64> [ 0 .. 5 ] Example: score=5 Delay index normalized score filter, used to restrict results to airports experiencing delays. 5 is the maximum delay. |
extendedOptions | Array of strings Items Enum: "useHttpErrors" "includeNewFields" "useInlinedReferences" "languageCode:en" "languageCode:ar" "languageCode:de" "languageCode:es" "languageCode:fr" "languageCode:ja" "languageCode:ko" "languageCode:pt" "languageCode:zh" Extended options for modifying standard API behavior to fit special use cases |