Download OpenAPI specification:Download
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:
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:
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.
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
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
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
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
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)
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.
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 |
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. |
Flight Status response with multiple flights, default options (this is a departure request but the response is essentially the same)
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.
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 |
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. |
Flight Status response with multiple flights, default options
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.
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 |
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. |
Flight Status response with a single flight, default options (this is a departure request, but the response is essentially the same)
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.
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 |
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. |
Flight Status response with a single flight, default options
Returns the Flight Status associated with provided Flight ID. The Flight ID is an arbitrary number that FlightStats uses to uniquely identify flights.
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 |
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. |
Returns the Flight Statuses for flights with the given tail number.
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 |
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. |
Returns the status of all flights for a given route arriving on the specified date
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 |
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. |
Returns the status of all flights for a given route departing on the specified date
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 |
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. |