Download OpenAPI specification:Download
The Schedules APIs, part of the FlightStats APIs, delivers access to the schedule information for upcoming flights. Responses are delivered in multiple languages, as either an XML or JSON response type. The web service features convenient search methods by flight, route, and airport to compliment our real-time FlightStatus API.
Schedules APIs answer questions such as:
The categories of Schedule APIs include:
Besides the normal extended options, the Schedules APIs support:
Scheduled Flights by flight APIs are standard APIs and included in our Commercial and Contract plans.
Scheduled Flights 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
Codeshares and wet lease relationships - Explanation of codeshares and wet lease relationships
Connections - Connections returns schedules for connecting flights between two airports
Flight Status - Current flight information for flights about three days in advance of departure until about seven days after arrival
Flight Data (Laminar Data Hub) - Status and positional data appropriate for geospatial-aware applciations
Scheduled Flight(s) arriving at the given airport at the given date and hour
format required | string Enum: "json" "jsonp" "xml" Example: json The data format returned in the response |
arrivalAirportCode required | string Example: PSP The airport code of the arrival airport |
year required | string Example: 2022 Four-digit year |
month required | integer <int64> [ 1 .. 12 ] Example: 10 Month |
day required | integer <int64> [ 1 .. 31 ] Example: 1 Day of month |
hourOfDay required | string Example: 14 Hour of day |
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" "useInlinedReferences" "includeCargo" "includeDirects" "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 |
Scheduled Flight(s) departing from the given airport at the given date and hour
format required | string Enum: "json" "jsonp" "xml" Example: json The data format returned in the response |
departureAirportCode required | string Example: PDX The airport code of the departure airport. |
year required | string Example: 2022 Four-digit year |
month required | integer <int64> [ 1 .. 12 ] Example: 10 Month |
day required | integer <int64> [ 1 .. 31 ] Example: 1 Day of month |
hourOfDay required | string Example: 14 Hour of day |
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" "useInlinedReferences" "includeCargo" "includeDirects" "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 |
Schedule response for by flight with default options (this is by arrival but the response is the same)
Scheduled Flight(s) by carrier and flight number, arriving on the given date
format required | string Enum: "json" "jsonp" "xml" Example: json The data format returned in the response |
carrier required | string Example: AS Carrier (airline) code |
flightNumber required | string Example: 412 Flight number |
year required | string Example: 2022 Four-digit year |
month required | integer <int64> [ 1 .. 12 ] Example: 10 Month |
day required | integer <int64> [ 1 .. 31 ] Example: 1 Day of month |
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" "useInlinedReferences" "includeCargo" "includeDirects" "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 |
Schedule response for by flight arrival with default options
Scheduled Flight(s) by carrier and flight number, departing on the given date
format required | string Enum: "json" "jsonp" "xml" Example: json The data format returned in the response |
carrier required | string Example: AS Carrier (airline) code |
flightNumber required | integer <int64> Example: 412 Flight number |
year required | string Example: 2022 Four-digit year |
month required | integer <int64> [ 1 .. 12 ] Example: 10 Month (1 to 12) |
day required | integer <int64> [ 1 .. 31 ] Example: 1 Day of month |
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" "useInlinedReferences" "includeCargo" "includeDirects" "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 |
Scheduled Flight(s) by route, arriving on the given date
format required | string Enum: "json" "jsonp" "xml" Example: json The data format returned in the response |
departureAirportCode required | string Example: PDX The airport code of the departure airport |
arrivalAirportCode required | string Example: PSP The airport code of the arrival airport |
year required | string Example: 2022 Four-digit year |
month required | integer <int64> [ 1 .. 12 ] Example: 10 Month |
day required | integer <int64> [ 1 .. 31 ] Example: 1 Day of month |
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" "useInlinedReferences" "includeCargo" "includeDirects" "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 |
Scheduled Flight(s) by route, departing on the given date
format required | string Enum: "json" "jsonp" "xml" Example: json The data format returned in the response |
departureAirportCode required | string Example: PDX The airport code of the departure airport |
arrivalAirportCode required | string Example: PSP The airport code of the arrival airport |
year required | string Example: 2022 Four-digit year |
month required | integer <int64> [ 1 .. 12 ] Example: 10 Month |
day required | integer <int64> [ 1 .. 31 ] Example: 1 Day of month |
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" "useInlinedReferences" "includeCargo" "includeDirects" "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 |