Airport Delay Index API

Download OpenAPI specification:Download

Introduction

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

  • 4 to 5 - Excessive
  • 3 to 4 - Significant
  • 2 to 3 - Moderate
  • 1 to 2 - Low
  • 0 to 1 - Very Low

Airport Delay Index APIs answer questions such as:

  • What are the major airports with significant delays in this country or region?
  • Is my flight likely to be on time given current conditions at a specific airport?
  • How bad is the delay?

Licensing

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

Schemas

Click the download button at the top of this document to download the OpenApi spec for this API. Other schemas:

APIs

Example implementations

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

Related products

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

Authentication

appIdQueryParam

ID of the application making the request

Security Scheme Type API Key
Query parameter name: appId

appKeyQueryParam

Authentication key of the application making the request

Security Scheme Type API Key
Query parameter name: appKey

appIdHeader

ID of the application making the request

Security Scheme Type API Key
Header parameter name: appId

appKeyHeader

Authentication key of the application making the request

Security Scheme Type API Key
Header parameter name: appKey

By airport

Returns the current DelayIndex(es) for the given Airport(s)

path Parameters
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

query Parameters
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

Responses

Response samples

Content type

Delay Index Response

Loading...

By country

Returns DelayIndexes for airports in the given Country

path Parameters
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

query Parameters
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

Responses

Response samples

Content type
No sample

By region

Returns DelayIndexes for airports in the given Region

path Parameters
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

query Parameters
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

Responses

Response samples

Content type
No sample

By state

Returns DelayIndexes for airports in the given State (US and Canada only)

path Parameters
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

query Parameters
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

Responses

Response samples

Content type
No sample
)