Flight Schedules API

Download OpenAPI specification:Download

URL: https://helpdesk.cirium.com/ Terms of Service

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

Authorizations:
appIdQueryParam
    appKeyQueryParam
      appIdHeader
        appKeyHeader
          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
          application/xml
          application/xml
          application/json
          application/javascript; charset=UTF-8
          No sample

          Airport by departure

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

          Authorizations:
          appIdQueryParam
            appKeyQueryParam
              appIdHeader
                appKeyHeader
                  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
                  application/json
                  application/json
                  application/xml
                  application/javascript; charset=UTF-8

                  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

                  Authorizations:
                  appIdQueryParam
                    appKeyQueryParam
                      appIdHeader
                        appKeyHeader
                          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
                          application/json
                          application/json
                          application/xml
                          application/javascript; charset=UTF-8

                          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

                          Authorizations:
                          appIdQueryParam
                            appKeyQueryParam
                              appIdHeader
                                appKeyHeader
                                  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
                                  application/xml
                                  application/xml
                                  application/json
                                  application/javascript; charset=UTF-8
                                  No sample

                                  By route

                                  Scheduled Flights By Route

                                  Route by arrival

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

                                  Authorizations:
                                  appIdQueryParam
                                    appKeyQueryParam
                                      appIdHeader
                                        appKeyHeader
                                          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
                                          application/xml
                                          application/xml
                                          application/json
                                          application/javascript; charset=UTF-8
                                          No sample

                                          Route by departure

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

                                          Authorizations:
                                          appIdQueryParam
                                            appKeyQueryParam
                                              appIdHeader
                                                appKeyHeader
                                                  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
                                                  application/xml
                                                  application/xml
                                                  application/json
                                                  application/javascript; charset=UTF-8
                                                  No sample
                                                  )