Airport Delay Index API

Download OpenAPI specification:Download

URL: https://helpdesk.cirium.com/ Terms of Service

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)

Authorizations:
appIdQueryParam
    appKeyQueryParam
      appIdHeader
        appKeyHeader
          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
          application/json
          application/json
          application/xml
          application/javascript; charset=UTF-8

          Delay Index Response

          Loading...

          By country

          Returns DelayIndexes for airports in the given Country

          Authorizations:
          appIdQueryParam
            appKeyQueryParam
              appIdHeader
                appKeyHeader
                  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
                  application/xml
                  application/xml
                  application/json
                  application/javascript; charset=UTF-8
                  No sample

                  By region

                  Returns DelayIndexes for airports in the given Region

                  Authorizations:
                  appIdQueryParam
                    appKeyQueryParam
                      appIdHeader
                        appKeyHeader
                          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
                          application/xml
                          application/xml
                          application/json
                          application/javascript; charset=UTF-8
                          No sample

                          By state

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

                          Authorizations:
                          appIdQueryParam
                            appKeyQueryParam
                              appIdHeader
                                appKeyHeader
                                  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
                                  application/xml
                                  application/xml
                                  application/json
                                  application/javascript; charset=UTF-8
                                  No sample
                                  )