Current Flight Status API

Download OpenAPI specification:Download

Introduction

Flight Status APIs, part of the FlightStats APIs, provide current flight information, including scheduled, estimated and actual departure/arrival times, equipment type, delay calculations, terminal, gate and baggage carousel.

Flight Status APIs answer questions such as:

  • Is the flight on time?
  • How long is the delay?
  • Is it cancelled?
  • What is the departure or arrival gate and terminal?
  • What airplane type is the airline using?

Current flight information is available for flights about three days in advance of departure until about seven days after arrival.

The categories of Flight Status APIs include:

  • By airport - Flights departing from or arriving 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) departing/arriving on a given date

Extended options

Besides the normal extended options, the Flight Status APIs support includeDeltas. When set, the API response includes flightStatusUpdates which describe changes to a flight status over time.

Licensing

Flight Status by flight APIs are standard APIs and included in our Commercial and Contract plans.

Flight Status by route and airport are premium APIs and only available in the Contract plan.

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:

By Flight long term support

By Flight extended fields

By Airport long term support

By Airport extended fields

By Route long term support

By Route extended fields

Example implementations

FlightStats Flight Tracker - Single Flight - Status by Flight number

FlightStats Flight Tracker - By Route - Status by Route by Departure

FlightStats Flight Tracker - By Airport - Status by Airport by Departure

Related articles

Look up the status of any commercial flight - Showcase article on how to use Flight Status By Flight APIs

Check airport arrivals status - Showcase article on how to use Flight Status By Airport APIs

Cirium flight status - Explanation of Cirium flight status data set

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

Related products

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

Historical Flight Status - Status for flights back to 2006

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)

By airport

Flight Status By Airport

Airport by arrival

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

Authorizations:
(appIdQueryParamappKeyQueryParam) (appIdHeaderappKeyHeader)
path Parameters
format
required
string
Enum: "json" "jsonp" "xml"
Example: json

The data format returned in the response

airport
required
string
Example: PIT

Arrival airport code

year
required
string
Example: 2021

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=AA

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
integer <int64> >= 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" "useInlinedReferences" "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. Besides the normal extended options, the Flight Status APIs support includeDeltas. When set, the API response includes flightStatusUpdates which describe changes to a flight status over time.

Responses

Response samples

Content type
Example

Flight Status response with multiple flights, default options (this is a departure request but the response is essentially the same)

Loading...

Airport by departure

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

Authorizations:
(appIdQueryParamappKeyQueryParam) (appIdHeaderappKeyHeader)
path Parameters
format
required
string
Enum: "json" "jsonp" "xml"
Example: json

The data format returned in the response

airport
required
string
Example: PIT

Departure airport code

year
required
string
Example: 2021

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 given as UTC instead of local

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

Number of hours worth of departures to include

carrier
string
Example: carrier=AA

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
integer <int64> >= 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" "useInlinedReferences" "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. Besides the normal extended options, the Flight Status APIs support includeDeltas. When set, the API response includes flightStatusUpdates which describe changes to a flight status over time.

Responses

Response samples

Content type
Example

Flight Status response with multiple flights, default options

Loading...

By flight

Flight Status By Flight

Flight by arrival date

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.

Authorizations:
(appIdQueryParamappKeyQueryParam) (appIdHeaderappKeyHeader)
path Parameters
format
required
string
Enum: "json" "jsonp" "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
string
Example: 2021

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" "useInlinedReferences" "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. Besides the normal extended options, the Flight Status APIs support includeDeltas. When set, the API response includes flightStatusUpdates which describe changes to a flight status over time.

Responses

Response samples

Content type
Example

Flight Status response with a single flight, default options (this is a departure request, but the response is essentially the same)

Loading...

Flight by departure date

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.

Authorizations:
(appIdQueryParamappKeyQueryParam) (appIdHeaderappKeyHeader)
path Parameters
format
required
string
Enum: "json" "jsonp" "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
string

Four-digit year

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

Month

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

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 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" "useInlinedReferences" "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. Besides the normal extended options, the Flight Status APIs support includeDeltas. When set, the API response includes flightStatusUpdates which describe changes to a flight status over time.

Responses

Response samples

Content type
Example

Flight Status response with a single flight, default options

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.

Authorizations:
(appIdQueryParamappKeyQueryParam) (appIdHeaderappKeyHeader)
path Parameters
format
required
string
Enum: "json" "jsonp" "xml"
Example: json

The data format returned in the response

flightId
required
integer <int64>

FlightStats' Flight ID number for the desired flight

query Parameters
extendedOptions
Array of strings
Items Enum: "useHttpErrors" "includeDeltas" "useInlinedReferences" "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. Besides the normal extended options, the Flight Status APIs support includeDeltas. When set, the API response includes flightStatusUpdates which describe changes to a flight status over time.

Responses

Response samples

Content type
No sample

Flight by tail number

Returns the Flight Statuses for flights with the given tail number.

Authorizations:
(appIdQueryParamappKeyQueryParam) (appIdHeaderappKeyHeader)
path Parameters
format
required
string
Enum: "json" "jsonp" "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
string
Example: 2021

Four-digit year

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

Month

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

Day of month

query Parameters
numDays
integer <int64> [ 1 .. 31 ]
Default: 1

Number of days

extendedOptions
Array of strings
Items Enum: "useHttpErrors" "includeDeltas" "useInlinedReferences" "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. Besides the normal extended options, the Flight Status APIs support includeDeltas. When set, the API response includes flightStatusUpdates which describe changes to a flight status over time.

Responses

Response samples

Content type
No sample

By route

Flight Status By Route

Route by arrival date

Returns the status of all flights for a given route arriving on the specified date

Authorizations:
(appIdQueryParamappKeyQueryParam) (appIdHeaderappKeyHeader)
path Parameters
format
required
string
Enum: "json" "jsonp" "xml"
Example: json

The data format returned in the response

departureAirport
required
string

Departure airport code

arrivalAirport
required
string

Arrival airport code

year
required
string

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

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

Number of hours worth of arrivals to include

utc
boolean
Default: false
Enum: true false

Time given as UTC instead of local

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.

nonstopOnly
boolean
Default: true
Enum: true false

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

extendedOptions
Array of strings
Items Enum: "useHttpErrors" "includeDeltas" "useInlinedReferences" "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. Besides the normal extended options, the Flight Status APIs support includeDeltas. When set, the API response includes flightStatusUpdates which describe changes to a flight status over time.

Responses

Response samples

Content type
No sample

Route by departure date

Returns the status of all flights for a given route departing on the specified date

Authorizations:
(appIdQueryParamappKeyQueryParam) (appIdHeaderappKeyHeader)
path Parameters
format
required
string
Enum: "json" "jsonp" "xml"
Example: json

The data format returned in the response

departureAirport
required
string

Departure airport code

arrivalAirport
required
string

Arrival airport code

year
required
string

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

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

Number of hours worth of arrivals to include

utc
boolean
Default: false
Enum: true false

Time given as UTC instead of local

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.

nonstopOnly
boolean
Default: true
Enum: true false

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

extendedOptions
Array of strings
Items Enum: "useHttpErrors" "includeDeltas" "useInlinedReferences" "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. Besides the normal extended options, the Flight Status APIs support includeDeltas. When set, the API response includes flightStatusUpdates which describe changes to a flight status over time.

Responses

Response samples

Content type
No sample