Flight Schedules API

Download OpenAPI specification:Download

Introduction

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:

  • What are all the scheduled flights arriving or departing an airport on a date?
  • What are all the scheduled flights for a carrier and flight number on a date?
  • What are all the scheduled flights between two airports on a date?

The categories of Schedule APIs include:

  • By airport - Flights departing from or arriving at a specific airport on a given date in the future
  • By flight - Status for a particular flight on a given date in the future
  • By route - Flights on a route (departure & arrival airport pair) departing/arriving on a given date

Extended options

Besides the normal extended options, the Schedules APIs support:

  • includeDirects - Includes direct flights (flights with intermediate stops) that would otherwise be omitted from the results
  • includeCargo - Includes cargo only flights that would otherwise be omitted from the results
  • includeSurface - Includes scheduled surface transportation that would otherwise be omitted from the results

Licensing

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

Schemas

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

Long term support

Extended fields

Related articles

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

Related products

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

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

Scheduled Flights By Airport

Airport by arrival

Scheduled Flight(s) arriving at the given airport at the given date and hour

path Parameters
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

query Parameters
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

Responses

Response samples

Content type
No sample

Airport by departure

Scheduled Flight(s) departing from the given airport at the given date and hour

path Parameters
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

query Parameters
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

Responses

Response samples

Content type

Schedule response for by flight with default options (this is by arrival but the response is the same)

Loading...

By flight

Scheduled Flights By Flight

Flight by arrival

Scheduled Flight(s) by carrier and flight number, arriving on the given date

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

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

query Parameters
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

Responses

Response samples

Content type

Schedule response for by flight arrival with default options

Loading...

Flight by departure

Scheduled Flight(s) by carrier and flight number, departing on the given date

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

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

query Parameters
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

Responses

Response samples

Content type
No sample

By route

Scheduled Flights By Route

Route by arrival

Scheduled Flight(s) by route, arriving on the given date

path Parameters
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

query Parameters
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

Responses

Response samples

Content type
No sample

Route by departure

Scheduled Flight(s) by route, departing on the given date

path Parameters
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

query Parameters
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

Responses

Response samples

Content type
No sample
)