Historical Flight Status API

Download OpenAPI specification:Download

Introduction

The Historical Flight Status APIs, part of the FlightStats APIs, give you access to historical flight information, including scheduled, estimated and actual departure/arrival times, equipment type, delay calculations, terminal, gate and baggage carousel.

Historical Flight Status APIs answer questions such as:

  • Was a flight cancelled or diverted?
  • Was a flight delayed and by how much?
  • What equipment was flown?

Historical Flight Status data is available for flights from February 7, 2006 to present day.

Queries are supported by flight history id; airline, flight number, and date; departure or arrival airport and date; and by route and date.

The categories of Historical Flight Status APIs include:

  • By airport - Flights that departed from or arrived at a specific airport on a given date
  • By flight - Status for a particular flight
  • By route - Flights on a route (departure & arrival airport pair) that departed or arrived on a given date

Extended options

Historical Flight Status uses the standard extended options with the following changes/additions:

  • includeDeltas - When specified, the API response includes flightStatusUpdates which describe changes to a flight status over time.
  • excludeAppendix - Unlike other APIs, appendix information is included by default. Specify excludeAppendex if you do not want the appendix.
  • useInlinedReferences - This is not supported in these APIs
  • includeNewFields - This is not supported in these APIS. New fields may be added at any time. Existing fields only change with a new API version. Fields noted as new in the supporting airport and airline appendix documentation will always be included (if present).

Licensing

This is a Premium API available within our Contract Plan.

A breakdown of the available plans is available on Get evaluation account

Our terms and conditions prohibit the use of Cirium Services or the Cirium Data for any passenger rights claims actions, for example actions pursuant to EU Regulation 261/2004.

Schemas

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

API Links

Related articles

Cirium flight status - Explanation of Cirium flight status data set

Codeshares and wet lease relationships - Explanation of codeshares and wet lease relationships

Related products

Flight Status - Current flight information for flights about three days in advance of departure until about seven days after arrival

FIDS - Flight Status API built specifcally to support for Flight Information Display Systems

Flight Alerts - Push based alerts for single flights or bulk

Flight Data (Laminar Data Hub) - Status and positional data appropriate for geospatial-aware applciations

Trip Status (Trips & Waivers) - Status combined with your travel trips (pull or push)

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

Historical Flight Status By Airport

Airport by arrival

Returns the status of all flights having arrived at an airport within the specified hour, or within a window up to 6 hours wide if numHours is specified.

path Parameters
format
required
string
Enum: "json" "xml"
Example: json

The data format returned in the response

airport
required
string
Example: PIT

Arrival airport code

year
required
integer <int64>
Example: 2010

Four-digit year

month
required
integer <int64> [ 1 .. 12 ]
Example: 9

Month

day
required
integer <int64> [ 1 .. 31 ]
Example: 1

Day of month

hourOfDay
required
integer <int64> [ 0 .. 23 ]
Example: 14

Hour of day

query Parameters
utc
boolean
Default: false
Enum: true false

Time given as UTC instead of local

numHours
integer <int64> [ 1 .. 6 ]
Default: 1
Example: numHours=3

Number of hours worth of arrivals to include.

carrier
string
Example: carrier=AS

Filter results to the carrier indicated

codeType
string
Enum: "IATA" "ICAO" "FS"
Example: codeType=FS

Airport code type. If not specified, the code searches in the order: IATA, ICAO, FS.

maxFlights
string >= 1
Example: maxFlights=20

The maximum number of unique flights to return status documents for. Used to restrict output size for the API documentation; if omitted, the API returns all flights.

extendedOptions
Array of strings
Items Enum: "useHttpErrors" "includeDeltas" "excludeAppendix" "includeNewFields" "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
Example

Example response, this is from a single ByFlightByID request, but the response is basically the same with more flight status elements.

Loading...

Airport by departure

Returns the status of all flights having departed from an airport within the specified hour, or within a window up to 6 hours wide if numHours is specified.

path Parameters
format
required
string
Enum: "json" "xml"
Example: json

The data format returned in the response

airport
required
string
Example: PIT

Departure airport code

year
required
integer <int64>
Example: 2010

Four-digit year

month
required
integer <int64> [ 1 .. 12 ]
Example: 9

Month

day
required
integer <int64> [ 1 .. 31 ]
Example: 1

Day of month

hourOfDay
required
integer <int64> [ 0 .. 23 ]
Example: 14

Hour of day

query Parameters
utc
boolean
Default: false
Enum: true false
Example: utc=false

Time provided is UTC?

numHours
integer <int64> [ 1 .. 6 ]
Default: 1
Example: numHours=3

Number of hours worth of departures to include

carrier
string
Example: carrier=AS

Filter results to the carrier indicated

codeType
string
Enum: "IATA" "ICAO" "FS"
Example: codeType=FS

Airport code type. If not specified, the code searches in the order: IATA, ICAO, FS.

maxFlights
string >= 1
Example: maxFlights=30

The maximum number of unique flights to return status documents for. This restricts the number of flights returned; if omitted, the API returns all flights.

extendedOptions
Array of strings
Items Enum: "useHttpErrors" "includeDeltas" "excludeAppendix" "includeNewFields" "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
Example

Example response, this is from a single ByFlightByID request, but the response is basically the same with more flight status elements.

Loading...

By flight

Historical Flight Status By Flight

Flight by arrival

Returns the Flight Statuses for the given Carrier and Flight Number that arrived on the given date. To narrow the results to a given arrival airport, specify the arrival airport.

path Parameters
format
required
string
Enum: "json" "xml"
Example: json

The data format returned in the response

carrier
required
string
Example: AS

Carrier (airline) code

flight
required
string
Example: 412

Flight number

year
required
integer <int64>
Example: 2010

Four-digit year

month
required
integer <int64> [ 1 .. 12 ]
Example: 9

Month

day
required
integer <int64> [ 1 .. 31 ]
Example: 1

Day of month

query Parameters
utc
boolean
Default: false
Enum: true false

Time given as UTC instead of local

airport
string
Example: airport=PDX

Optional arrival airport code

codeType
string
Enum: "IATA" "ICAO" "FS"
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" "includeDeltas" "excludeAppendix" "includeNewFields" "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
Example

Example response, this is from a single ByFlightByID request, but the response is basically the same.

Loading...

Flight by departure

Returns the Flight Statuses for the given Carrier and Flight Number that departed on the given date. To narrow the results to a given departure airport, specify the arrival airport.

path Parameters
format
required
string
Enum: "json" "xml"
Example: json

The data format returned in the response

carrier
required
string
Example: AS

Carrier (airline) code

flight
required
string
Example: 412

Flight number

year
required
integer <int64>
Example: 2010

Four-digit year

month
required
integer <int64> [ 1 .. 12 ]
Example: 9

Month

day
required
integer <int64> [ 1 .. 31 ]
Example: 1

Day of month

query Parameters
utc
boolean
Default: false
Enum: true false

Time given as UTC instead of local (default is false)?

airport
string
Example: airport=PDX

Optional departure airport code

codeType
string
Enum: "IATA" "ICAO" "FS"
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" "includeDeltas" "excludeAppendix" "includeNewFields" "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
Example

Example response, this is from a single ByFlightByID request, but the response is basically the same.

Loading...

Flight by ID

Returns the Flight Status associated with provided Flight ID. The Flight ID is an arbitrary number that FlightStats uses to uniquely identify flights.

path Parameters
format
required
string
Enum: "json" "xml"
Example: json

The data format returned in the response

flightId
required
integer <int64>
Example: 1003242

FlightStats' Flight ID number for the desired flight

query Parameters
extendedOptions
Array of strings
Items Enum: "useHttpErrors" "includeDeltas" "excludeAppendix" "includeNewFields" "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
Example

Example response

Loading...

Flight by tail number

Returns the Flight Statuses for flights with the given tail number in the given date range.

path Parameters
format
required
string
Enum: "json" "xml"
Example: json

The data format returned in the response

tailNumber
required
string
Example: N832AA

Returns the Flight Statuses for flights with the given tail number

year
required
integer <int64>
Example: 2020

Four-digit year

month
required
integer <int64> [ 1 .. 12 ]
Example: 9

Month

day
required
integer <int64> [ 1 .. 31 ]
Example: 1

Day of month

query Parameters
numDays
string [ 1 .. 31 ]
Default: "7"

Number of days from the date specified to include in results

extendedOptions
Array of strings
Items Enum: "useHttpErrors" "includeDeltas" "excludeAppendix" "includeNewFields" "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
Example

Example response, this is from a single ByFlightByID request, but the response is basically the same.

Loading...

By route

Historical Status By Route

Route by arrival

Returns the status of all flights for a given route that arrived on the specified date.

path Parameters
format
required
string
Enum: "json" "xml"
Example: json

The data format returned in the response

departureAirport
required
string
Example: PDX

Departure Airport code

arrivalAirport
required
string
Example: SEA

Arrival Airport code

year
required
integer <int64>
Example: 2010

Four-digit year

month
required
integer <int64> [ 1 .. 12 ]
Example: 9

Month

day
required
integer <int64> [ 1 .. 31 ]
Example: 1

Day of month

query Parameters
hourOfDay
integer <int64> [ 0 .. 23 ]
Example: hourOfDay=14

Hour of day

utc
boolean
Default: false
Enum: true false

Time given as UTC instead of local

numHours
integer <int64> [ 1 .. 24 ]
Default: 24

Number of hours worth of departures to include.

codeType
string
Enum: "IATA" "ICAO" "FS"
Example: codeType=FS

Airport code type. If not specified, the code searches in the order: IATA, ICAO, FS.

maxFlights
integer <int64> >= 1

The maximum number of unique flights to return status documents for. Restricts the number of flight returned; if omitted, the API returns all flights.

extendedOptions
Array of strings
Items Enum: "useHttpErrors" "includeDeltas" "excludeAppendix" "includeNewFields" "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

nonstopOnly
string
Default: "true"
Enum: "true" "false"

Filter results to include only nonstop flights matching specified departure and arrival airport.

Responses

Response samples

Content type
Example

Example response, this is from a single ByFlightByID request, but the response is basically the same with more flight status elements.

Loading...

Route by departure

Returns the status of all flights for a given route that arrived on the specified date.

path Parameters
format
required
string
Enum: "json" "xml"
Example: json

The data format returned in the response

departureAirport
required
string
Example: SEA

Departure Airport code

arrivalAirport
required
string
Example: PIT

Arrival Airport code

year
required
integer <int64>

Four-digit year

month
required
integer <int64> [ 1 .. 12 ]

Month

day
required
integer <int64> [ 1 .. 31 ]

Day of month

query Parameters
hourOfDay
integer <int64> [ 0 .. 23 ]

Hour of day

utc
boolean
Default: false
Enum: true false

Time given as UTC instead of local

numHours
integer <int64> [ 1 .. 24 ]
Default: 24

Number of hours' worth of departures to include.

codeType
string
Enum: "IATA" "ICAO" "FS"
Example: codeType=FS

Airport code type. If not specified, the code searches in the order: IATA, ICAO, FS.

maxFlights
string

The maximum number of unique flights to return status documents for. Restricts the number of flight returned; if omitted, the API returns all flights.

extendedOptions
Array of strings
Items Enum: "useHttpErrors" "includeDeltas" "excludeAppendix" "includeNewFields" "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

nonstopOnly
boolean
Default: true
Enum: true false

Filter results to include only nonstop flights matching specified departure and arrival airport.

Responses

Response samples

Content type
Example

Example response, this is from a single ByFlightByID request, but the response is basically the same with more flight status elements.

Loading...
)