Overview

The SITA Flight Schedule API is ideal for passenger or operations app developers that need reliable and accurate schedule information globally. The API provides schedules for upcoming flights, for airports worldwide. Data can be returned for specific airlines and divided into arriving or departing flights.

The flight schedules can be obtained based on airport or flight number.

Examples of information included: arrival/ departure, scheduled time, airport, terminal, claim, aircraft, marketingCarriers / operatingCarrier, airline, flightNumber, tailNumber.

Who uses it

Airlines & Airports operators, Global Distribution Systems (GDS), Data aggregators & system providers, Government agencies & authorities, Travel agents, Original Equipment Manufacturers (OEMs) & Education institutions.

Technical Documentation

version 1.2.0-SNAPSHOT

1 Revision History

Date	Version	Description
`08 March 2021`	`1.0`	`Initial Version`
`24 August 2022`	`1.1`	`Added continuationToken`
`13 October 2022`	`1.2`	`General Tidy Up and Update`
`20 July 2023`	`1.3`	`Added rate limit and OAuth`
`06 August 2023`	`1.4`	`Added Airline and Flight Number APIs`

To access the APIs you will need an API key. These can be obtained by creating an account on https://www.developer.aero/ and registering your interest for access to the API.

2.1 Authentication

To access the APIs an OAuth access token must be supplied in an Authorization header in the request. To obtain an OAuth token a request must be sent to the https://sitaopen.api.aero/schedule/oauth/token endpoint using the OAuth2 Client Credential flow.Use your API key as the client_id, and your consumer secret as the client_secret these should be base64 encoded in an Authorization header when sent to the OAuth endpoint.

Please note the OAuth tokens have an expiry of one hour after the token has been retrieved, after the token has expired you will need to re-issue a request to get a new token.

curl --location 'https://sitaopen.api.aero/schedule/oauth/token' \--header 'Authorization: Basic YWJjZGVmZ2hpamtsbW5vcC5xcnN0dXY='

You should then see your OAuth token in the response.

"access_token": "eyJ0eXAiOiJKV1QiLCJhbGciOJIUzI1NiJ9.eyJyZWZyZXNoX3Rva2VuX2V4cGlyZXNfaW4iOiIzNTk5Iiwic3ViIjoic2l0YSIsImFwaV9cm9kdWN0X2xpc3QiOiJbRE9UUy1GbGlnaHQtQ29ubmVjdGlvbi1JbnRlcm5hbF0iLCJpc3MiOiJ1cm46XC9cL2FwaWdlZS1lZdlLUpXVC1wb2xpY3ktdGVzdCIsImFwaV9hY2Nlc3NfdG9rZW4iOiIweXlIZHduSUdtOGo5WlN6WWtuYTBsWG9ZNTFvIiwiYXBpX3JlZnJlc2hfdG9rZW4iOiJraHNlaXN2T3JwSHBUd2NuUVRHdXdBdVdicXNpamNQTyIsImFwaV9zY29wZSI6IiIsImF1ZCI6ImFwaWdlZS1hcGkiLCJleHAiOj3MzAyOTI3MzIsImFwcF9pZCI6IjIxYzI5NTgyLTIwZTktNDkwMS1hNjExLTVkM2UwM2QxNzFkYiIsImV4cGlyZXNfaW4iOiIzNTk5IiwiaWF0IjoxNzMwMjg5MTMyLCJqdGkiOiI3ZmEzNTU4Mi0xNDhmLTRiMmEtODYxMS0wNWI4NDg5YjFjYmMifQ.g_dFH-08DGADOX9HIk7wzX5edxXejVsnCen27A25TQ0"

Once an access token has been obtained, it can be placed in the Authorization HTTP header as a bearer token, for example:

curl --location 'https://sitaopen.api.aero/schedule/v1/route/departure/MIA/arrival/JFK?operationDateFrom=2024-10-22&operationDateTo=2024-10-22 \
--header 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOJIUzI1NiJ9.eyJyZWZyZXNoX3Rva2VuX2V4cGlyZXNfaW4iOiIzNTk5Iiwic3ViIjoic2l0YSIsImFwaV9cm9kdWN0X2xpc3QiOiJbRE9UUy1GbGlnaHQtQ29ubmVjdGlvbi1JbnRlcm5hbF0iLCJpc3MiOiJ1cm46XC9cL2FwaWdlZS1lZdlLUpXVC1wb2xpY3ktdGVzdCIsImFwaV9hY2Nlc3NfdG9rZW4iOiIweXlIZHduSUdtOGo5WlN6WWtuYTBsWG9ZNTFvIiwiYXBpX3JlZnJlc2hfdG9rZW4iOiJraHNlaXN2T3JwSHBUd2NuUVRHdXdBdVdicXNpamNQTyIsImFwaV9zY29wZSI6IiIsImF1ZCI6ImFwaWdlZS1hcGkiLCJleHAiOj3MzAyOTI3MzIsImFwcF9pZCI6IjIxYzI5NTgyLTIwZTktNDkwMS1hNjExLTVkM2UwM2QxNzFkYiIsImV4cGlyZXNfaW4iOiIzNTk5IiwiaWF0IjoxNzMwMjg5MTMyLCJqdGkiOiI3ZmEzNTU4Mi0xNDhmLTRiMmEtODYxMS0wNWI4NDg5YjFjYmMifQ.g_dFH-08DGADOX9HIk7wzX5edxXejVsnCen27A25TQ0'

Flight Schedule API

The scheme, domain and high level path parameters portion of the URL is:

https://host:port/schedule/{version}

Where schedule is the functional domain. The current version is v1.

Following the schedule domain parameter, and version, the next path parameter(s) define the service called. As of this version, the following functions are provided:

Function	Method	Description
`/route/departure/{departureAirport}/arrival/{arrivalAirport}`	`GET`	`Returns the schedules based on the departure and arrival airports`
`/route/departure/{departureAirport}/arrival/{arrivalAirport}/airline/{airline}`	`GET`	`Returns all active flight schedules between a Departure and Arrival airport for the specified Airline.`
`/route/departure/{departureAirport}/arrival/{arrivalAirport}/airline/{airline}/flightNumber/{flightNumber}`	`GET`	`Returns all active flight schedules between a Departure and Arrival airport for the specified Airline/Flight number.`
`/airport/{airportCode}/direction/{adi}`	`GET`	`Returns all active flight schedules for a given Airport, filtered by departure/arrival.`
`/airline/{airline}`	`GET`	`Returns all active flight schedules for an Airline.`
`/airline/{airline}/flightNumber/{flightNumber}`	`GET`	`Returns all active flight schedules for an Airline/Flight number.`

2.3 Security

All incoming requests will be REST over HTTPS.
Users are authenticated using their OAuth token.
Certain response payload elements will be filtered based on permissions associated with their token.

2.4 Rate Limiting

All incoming requests are subject to a rate limiting restriction. The following headers are included in HTTP responses:

Header	Description
`X-RateLimit-Limit`	The total number of requests allowed in the current time window
`X-RateLimit-Remaining`	The number of requests left for the current time window
`X-RateLimit-Policy`	The policy describing how many request per time window are allowed
`X-RateLimit-Reset`	The number of seconds remaining in the current time window. Header not displayed after rate limit has been exceeded
`retry-after`	The epoch timestamp at which the current rate limit window resets. Header only displayed after rate limit has been exceeded

3 Flight Schedule API

The SITA Flight Schedule API provides flight schedule information for up to 1 year in advance in an easy to read JSON format. This information is derived from data supplied by OAG.

3.1 Resources

This section describes Flight Schedule API service. Detailed API structure, example requests and responses and JSON schema for request (where appropriate) and responses

Schedule By Departure and Arrival Stations

Path parameters

Table 1. /{version}/route/departure/{departure}/arrival/{arrival}
Parameter	Description
`version`	The version of this API e.g. v1
`departure`	Valid IATA/ICAO departure Airport Code
`arrival`	Valid IATA/ICAO arrival Airport Code

Request headers

Name	Description
`Content-Type`	The Content-Type of this request
`Authorization`	Authorization header that contains the access token.

Query parameters

Parameter	Description
`operationDateFrom`	Start Date for Operation Date Filter (Valid format is 'yyyy-MM-dd'). If not defined, current UTC date will be assigned
`operationDateTo`	End Date for Operation Date Filter (Valid format is 'yyyy-MM-dd'). If defined, operationDateFrom should also be present. If not defined, a 3 days window will be used based on operationDateFrom (if present) or the current UTC date.
`groupMarketingCarriers`	Group associated marketing and operating carrier flights into a single record. Default false.

Response fields

Path	Type	Description
`adi`	`String`	1-character direction indicator (A/D)
`airline`	`String`	2-character IATA or 3-character ICAO airline code
`arrival`	`String`	3-character IATA or 4-character ICAO arrival airport code
`continent`	`String`	2-character continent value
`continuationToken`	`String`	Indicates more results are available. Pass this value to the continuationToken parameter on the request to retrieve the next page
`country`	`String`	Country Name where airport is located
`departure`	`String`	3-character IATA or 4-character ICAO departure airport code
`flightNumber`	`String`	Flight number
`schedules[].aircraftOwner`	`String`	Aircraft owner
`schedules[].aircraftSTA`	`String`	Aircraft schedule time of arrival
`schedules[].aircraftSTD`	`String`	Aircraft scheduled time of departure
`schedules[].aircraftType`	`String`	Aircraft type
`schedules[].aircraftVersion`	`String`	Aircraft version
`schedules[].arrivalDayDifference`	`Number`	Arrival day difference
`schedules[].arrivalStation.city`	`String`	Arrival airport city
`schedules[].arrivalStation.continent`	`String`	Continent where airport is located
`schedules[].arrivalStation.country`	`String`	Arrival airport country
`schedules[].arrivalStation.countryCode`	`String`	Arrival airport country code
`schedules[].arrivalStation.elevation`	`Number`	Airport Elevation
`schedules[].arrivalStation.iataCode`	`String`	Arrival airport IATA code e.g JFK
`schedules[].arrivalStation.icaoCode`	`String`	Arrival airport ICAO code e.g KJFK
`schedules[].arrivalStation.ident`	`String`	Arrival airport ident
`schedules[].arrivalStation.lat`	`Number`	Arrival airport latitude position
`schedules[].arrivalStation.lng`	`Number`	Arrival airport longitude position
`schedules[].arrivalStation.localCode`	`String`	Arrival airport local code
`schedules[].arrivalStation.name`	`String`	Arrival airport full name
`schedules[].arrivalStation.region`	`String`	Arrival airport region
`schedules[].arrivalStation.timezone`	`String`	Arrival airport timezone
`schedules[].arrivalStation.type`	`String`	Arrival airport type e.g. LARGE_AIRPORT
`schedules[].cabinCrewEmployer`	`String`	Cabin crew employer
`schedules[].cockpitCrewEmployer`	`String`	Cockpit crew employer
`schedules[].daysOfOperation`	`Array`	Days of operation
`schedules[].departureDayDifference`	`Number`	Departure day difference
`schedules[].departureStation.city`	`String`	Departure airport city
`schedules[].departureStation.continent`	`String`	Departure airport continent
`schedules[].departureStation.country`	`String`	Departure airport country
`schedules[].departureStation.countryCode`	`String`	Departure airport country code
`schedules[].departureStation.elevation`	`Number`	Airport altitude
`schedules[].departureStation.iataCode`	`String`	Departure airport IATA code e.g JFK
`schedules[].departureStation.icaoCode`	`String`	Departure airport ICAO code e.g KJFK
`schedules[].departureStation.ident`	`String`	Departure airport identification
`schedules[].departureStation.lat`	`Number`	Departure airport latitude position
`schedules[].departureStation.lng`	`Number`	Departure airport longitude position
`schedules[].departureStation.localCode`	`String`	Departure airport local code
`schedules[].departureStation.name`	`String`	Departure airport full name
`schedules[].departureStation.region`	`String`	Departure airport region
`schedules[].departureStation.timezone`	`String`	Departure airport timezone
`schedules[].departureStation.type`	`String`	Departure airport type e.g. LARGE_AIRPORT
`schedules[].electronicTicketingCandidate`	`String`	Electronic ticketing candidate
`schedules[].flightTransitLayover`	`String`	Flight transit layover
`schedules[].frequencyRate`	`String`	Flight frequency rate
`schedules[].inFlightServiceInformation[].service`	`String`	Available in-flight service
`schedules[].itineraryVariationIdentifier`	`Number`	A number used to differentiate between itineraries with the same Flight Designator (excluding Operational Suffixes, if any)
`schedules[].itineraryVariationIdentifierOverflow`	`String`	Itinerary variation identifier
`schedules[].jointOperationAirline`	`String`	Joint operation airline
`schedules[].legSequenceNumber`	`Number`	Sequence number
`schedules[].marketingCarriers[].airlineDesignator`	`String`	Marketing airline code
`schedules[].marketingCarriers[].flightNumber`	`String`	Marketing airline flight number
`schedules[].marketingCarriers[].flightOperator`	`Boolean`	Indicates if the airline is the flight operator
`schedules[].mealService.mealServicePerClass[].mealService`	`Array`	Type of meal service e.g. Breakfast
`schedules[].mealService.mealServicePerClass[].passengerClass`	`String`	Passenger service class name e.g. BusinessClassPremium
`schedules[].mealService.mealServicePerClass[].passengerCode`	`String`	Passenger service class code e.g. A
`schedules[].minimumConnectingTime`	`String`	Minimum connecting time
`schedules[].onTimePerformanceIndicator`	`String`	On time performance indicator
`schedules[].onwardFlight.aircraftRotationLayover`	`String`	Aircraft rotation layover
`schedules[].onwardFlight.airlineDesignator`	`String`	Airline code of onward flight
`schedules[].onwardFlight.flightNumber`	`String`	Flight number of onward flight
`schedules[].onwardFlight.operationSuffix`	`String`	Flight suffix of onward flight e.g. 4A, 123B
`schedules[].operatingAirline`	`String`	Operating airline
`schedules[].operationBegin`	`String`	Operation begin date
`schedules[].operationEnd`	`String`	Operation end date
`schedules[].passengerArrivalTerminal`	`String`	Arrival terminal
`schedules[].passengerDepartureTerminal`	`String`	Departure terminal
`schedules[].passengerSTA`	`String`	Passenger schedule time of arrival
`schedules[].passengerSTD`	`String`	Passenger scheduled time of departure
`schedules[].prbd`	`String`	Passenger Reservations Booking Designator
`schedules[].prbm`	`String`	Passenger Reservations Booking Modifier
`schedules[].recordSerialNumber`	`String`	Record serial number
`schedules[].secureFlightIndicator`	`String`	Secure flight indicator
`schedules[].serviceType`	`String`	Service type
`schedules[].trafficRestrictionCode`	`Array`	Traffic restriction code
`schedules[].trafficRestrictionCodeLegOverflowIndication`	`String`	Traffic Restriction Code for flight leg
`schedules[].utcOffsetArrStation`	`String`	UTC offset at arrival airport
`schedules[].utcOffsetDepStation`	`String`	UTC offset at departure airport

Curl request

$ curl 'https://sitaopen.api.aero/schedule/v1/route/departure/JFK/arrival/LAX?operationDateFrom=2020-07-06&operationDateTo=2020-07-10&groupMarketingCarriers=true' -i -X GET \
    -H 'Authorization: Bearer eyJkb2N1bWVudGF0aW9uIiwidG9rZW4ifQ...' \
    -H 'Content-Type: application/json'

HTTP response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 3581
{
  "departure" : "JFK",
  "arrival" : "LAX",
  "adi" : "D",
  "continent" : "NA",
  "country" : "US",
  "schedules" : [ {
    "itineraryVariationIdentifier" : 1,
    "legSequenceNumber" : 1,
    "serviceType" : "J",
    "operationBegin" : "06JUL2020",
    "operationEnd" : "03JUL2021",
    "daysOfOperation" : [ "Monday", "Tuesday", "Thursday" ],
    "frequencyRate" : "2",
    "departureStation" : {
      "type" : "LARGE_AIRPORT",
      "elevation" : 13,
      "continent" : "NA",
      "countryCode" : "US",
      "region" : "US-NY",
      "localCode" : "JFK",
      "name" : "John F Kennedy International Airport",
      "iataCode" : "KJFK",
      "icaoCode" : "JFK",
      "city" : "New York",
      "country" : "US",
      "timezone" : "America/New_York",
      "ident" : "JFK",
      "lat" : 40.63980103,
      "lng" : -73.77890015
    },
    "passengerSTD" : "0730",
    "aircraftSTD" : "0730",
    "utcOffsetDepStation" : "-0500",
    "passengerDepartureTerminal" : "G",
    "arrivalStation" : {
      "type" : "LARGE_AIRPORT",
      "elevation" : 125,
      "continent" : "NA",
      "countryCode" : "US",
      "region" : "US-CA",
      "localCode" : "JFK",
      "name" : "Los Angeles International Airport",
      "iataCode" : "KLAX",
      "icaoCode" : "LAX",
      "city" : "Los Angeles",
      "country" : "US",
      "timezone" : "America/Los_Angeles",
      "ident" : "JFK",
      "lat" : 33.94250107,
      "lng" : -118.4079971
    },
    "aircraftSTA" : "1105",
    "passengerSTA" : "1105",
    "utcOffsetArrStation" : "-0700",
    "passengerArrivalTerminal" : "0",
    "aircraftType" : "32B",
    "prbd" : "FAJRDIYBHKMLGVSNQO",
    "prbm" : "N",
    "mealService" : {
      "mealServicePerClass" : [ {
        "passengerCode" : "F",
        "passengerClass" : "FirstClass",
        "mealService" : [ "Breakfast" ]
      }, {
        "passengerCode" : "J",
        "passengerClass" : "BusinessClassPremium",
        "mealService" : [ "Breakfast" ]
      }, {
        "passengerCode" : "Y",
        "passengerClass" : "EconomyOrCoach",
        "mealService" : [ "Snack or Brunch" ]
      }, {
        "passengerCode" : "V",
        "passengerClass" : "EconomyOrCoachDiscounted",
        "mealService" : [ "Snack or Brunch" ]
      } ]
    },
    "jointOperationAirline" : "AA",
    "minimumConnectingTime" : "0200",
    "secureFlightIndicator" : "S",
    "itineraryVariationIdentifierOverflow" : "2",
    "aircraftOwner" : "AA",
    "cockpitCrewEmployer" : "AA",
    "cabinCrewEmployer" : "AA",
    "onwardFlight" : {
      "airlineDesignator" : "AA",
      "flightNumber" : "1",
      "aircraftRotationLayover" : "0",
      "operationSuffix" : "A"
    },
    "flightTransitLayover" : "2",
    "operatingAirline" : "OPERATING_FLIGHT",
    "trafficRestrictionCode" : [ "O" ],
    "trafficRestrictionCodeLegOverflowIndication" : "Z",
    "aircraftVersion" : "A318",
    "departureDayDifference" : 0,
    "arrivalDayDifference" : 0,
    "recordSerialNumber" : "000003",
    "marketingCarriers" : [ {
      "airlineDesignator" : "TN",
      "flightNumber" : "1101",
      "flightOperator" : false
    } ],
    "inFlightServiceInformation" : [ {
      "service" : "Audio programming"
    }, {
      "service" : "Wi-Fi"
    }, {
      "service" : "In-seat Video Player/Library"
    }, {
      "service" : "USB Power"
    } ],
    "onTimePerformanceIndicator" : "80-89",
    "electronicTicketingCandidate" : "Y"
  } ],
  "continuationToken" : "Aw=="
}

Schedule By Departure, Arrival and Airline

Path parameters

Table 1. /{version}/route/departure/{departure}/arrival/{arrival}/airline/{airline}
Parameter	Description
`version`	The version of this API e.g. v1
`departure`	Valid IATA/ICAO departure Airport Code
`arrival`	Valid IATA/ICAO arrival Airport Code
`airline`	Valid IATA/ICAO Airline Code

Request headers

Name	Description
`Content-Type`	The Content-Type of this request
`Authorization`	Authorization header that contains the access token.

Query parameters

Parameter	Description
`operationDateFrom`	Start Date for Operation Date Filter (Valid format is 'yyyy-MM-dd'). If not defined, current UTC date will be assigned
`operationDateTo`	End Date for Operation Date Filter (Valid format is 'yyyy-MM-dd'). If defined, operationDateFrom should also be present. If not defined, a 3 days window will be used based on operationDateFrom (if present) or the current UTC date.
`groupMarketingCarriers`	Group associated marketing and operating carrier flights into a single record. Default false.

Response fields

Path	Type	Description
`adi`	`String`	1-character direction indicator (A/D)
`airline`	`String`	2-character IATA or 3-character ICAO airline code
`arrival`	`String`	3-character IATA or 4-character ICAO arrival airport code
`continent`	`String`	2-character continent value
`continuationToken`	`String`	Indicates more results are available. Pass this value to the continuationToken parameter on the request to retrieve the next page
`country`	`String`	Country Name where airport is located
`departure`	`String`	3-character IATA or 4-character ICAO departure airport code
`flightNumber`	`String`	Flight number
`schedules[].aircraftOwner`	`String`	Aircraft owner
`schedules[].aircraftSTA`	`String`	Aircraft schedule time of arrival
`schedules[].aircraftSTD`	`String`	Aircraft scheduled time of departure
`schedules[].aircraftType`	`String`	Aircraft type
`schedules[].aircraftVersion`	`String`	Aircraft version
`schedules[].arrivalDayDifference`	`Number`	Arrival day difference
`schedules[].arrivalStation.city`	`String`	Arrival airport city
`schedules[].arrivalStation.continent`	`String`	Continent where airport is located
`schedules[].arrivalStation.country`	`String`	Arrival airport country
`schedules[].arrivalStation.countryCode`	`String`	Arrival airport country code
`schedules[].arrivalStation.elevation`	`Number`	Airport Elevation
`schedules[].arrivalStation.iataCode`	`String`	Arrival airport IATA code e.g JFK
`schedules[].arrivalStation.icaoCode`	`String`	Arrival airport ICAO code e.g KJFK
`schedules[].arrivalStation.ident`	`String`	Arrival airport ident
`schedules[].arrivalStation.lat`	`Number`	Arrival airport latitude position
`schedules[].arrivalStation.lng`	`Number`	Arrival airport longitude position
`schedules[].arrivalStation.localCode`	`String`	Arrival airport local code
`schedules[].arrivalStation.name`	`String`	Arrival airport full name
`schedules[].arrivalStation.region`	`String`	Arrival airport region
`schedules[].arrivalStation.timezone`	`String`	Arrival airport timezone
`schedules[].arrivalStation.type`	`String`	Arrival airport type e.g. LARGE_AIRPORT
`schedules[].cabinCrewEmployer`	`String`	Cabin crew employer
`schedules[].cockpitCrewEmployer`	`String`	Cockpit crew employer
`schedules[].daysOfOperation`	`Array`	Days of operation
`schedules[].departureDayDifference`	`Number`	Departure day difference
`schedules[].departureStation.city`	`String`	Departure airport city
`schedules[].departureStation.continent`	`String`	Departure airport continent
`schedules[].departureStation.country`	`String`	Departure airport country
`schedules[].departureStation.countryCode`	`String`	Departure airport country code
`schedules[].departureStation.elevation`	`Number`	Airport altitude
`schedules[].departureStation.iataCode`	`String`	Departure airport IATA code e.g JFK
`schedules[].departureStation.icaoCode`	`String`	Departure airport ICAO code e.g KJFK
`schedules[].departureStation.ident`	`String`	Departure airport identification
`schedules[].departureStation.lat`	`Number`	Departure airport latitude position
`schedules[].departureStation.lng`	`Number`	Departure airport longitude position
`schedules[].departureStation.localCode`	`String`	Departure airport local code
`schedules[].departureStation.name`	`String`	Departure airport full name
`schedules[].departureStation.region`	`String`	Departure airport region
`schedules[].departureStation.timezone`	`String`	Departure airport timezone
`schedules[].departureStation.type`	`String`	Departure airport type e.g. LARGE_AIRPORT
`schedules[].electronicTicketingCandidate`	`String`	Electronic ticketing candidate
`schedules[].flightTransitLayover`	`String`	Flight transit layover
`schedules[].frequencyRate`	`String`	Flight frequency rate
`schedules[].inFlightServiceInformation[].service`	`String`	Available in-flight service
`schedules[].itineraryVariationIdentifier`	`Number`	A number used to differentiate between itineraries with the same Flight Designator (excluding Operational Suffixes, if any)
`schedules[].itineraryVariationIdentifierOverflow`	`String`	Itinerary variation identifier
`schedules[].jointOperationAirline`	`String`	Joint operation airline
`schedules[].legSequenceNumber`	`Number`	Sequence number
`schedules[].marketingCarriers[].airlineDesignator`	`String`	Marketing airline code
`schedules[].marketingCarriers[].flightNumber`	`String`	Marketing airline flight number
`schedules[].marketingCarriers[].flightOperator`	`Boolean`	Indicates if the airline is the flight operator
`schedules[].mealService.mealServicePerClass[].mealService`	`Array`	Type of meal service e.g. Breakfast
`schedules[].mealService.mealServicePerClass[].passengerClass`	`String`	Passenger service class name e.g. BusinessClassPremium
`schedules[].mealService.mealServicePerClass[].passengerCode`	`String`	Passenger service class code e.g. A
`schedules[].minimumConnectingTime`	`String`	Minimum connecting time
`schedules[].onTimePerformanceIndicator`	`String`	On time performance indicator
`schedules[].onwardFlight.aircraftRotationLayover`	`String`	Aircraft rotation layover
`schedules[].onwardFlight.airlineDesignator`	`String`	Airline code of onward flight
`schedules[].onwardFlight.flightNumber`	`String`	Flight number of onward flight
`schedules[].onwardFlight.operationSuffix`	`String`	Flight suffix of onward flight e.g. 4A, 123B
`schedules[].operatingAirline`	`String`	Operating airline
`schedules[].operationBegin`	`String`	Operation begin date
`schedules[].operationEnd`	`String`	Operation end date
`schedules[].passengerArrivalTerminal`	`String`	Arrival terminal
`schedules[].passengerDepartureTerminal`	`String`	Departure terminal
`schedules[].passengerSTA`	`String`	Passenger schedule time of arrival
`schedules[].passengerSTD`	`String`	Passenger scheduled time of departure
`schedules[].prbd`	`String`	Passenger Reservations Booking Designator
`schedules[].prbm`	`String`	Passenger Reservations Booking Modifier
`schedules[].recordSerialNumber`	`String`	Record serial number
`schedules[].secureFlightIndicator`	`String`	Secure flight indicator
`schedules[].serviceType`	`String`	Service type
`schedules[].trafficRestrictionCode`	`Array`	Traffic restriction code
`schedules[].trafficRestrictionCodeLegOverflowIndication`	`String`	Traffic Restriction Code for flight leg
`schedules[].utcOffsetArrStation`	`String`	UTC offset at arrival airport
`schedules[].utcOffsetDepStation`	`String`	UTC offset at departure airport

Curl request

$ curl 'https://sitaopen.api.aero/schedule/v1/route/departure/JFK/arrival/LAX/airline/AA?operationDateFrom=2020-07-06&operationDateTo=2020-07-10&groupMarketingCarriers=true' -i -X GET \
    -H 'Authorization: Bearer eyJkb2N1bWVudGF0aW9uIiwidG9rZW4ifQ...' \
    -H 'Content-Type: application/json'

HTTP response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 3602
{
  "departure" : "JFK",
  "arrival" : "LAX",
  "airline" : "AA",
  "adi" : "D",
  "continent" : "NA",
  "country" : "US",
  "schedules" : [ {
    "itineraryVariationIdentifier" : 1,
    "legSequenceNumber" : 1,
    "serviceType" : "J",
    "operationBegin" : "06JUL2020",
    "operationEnd" : "03JUL2021",
    "daysOfOperation" : [ "Monday", "Tuesday", "Thursday" ],
    "frequencyRate" : "2",
    "departureStation" : {
      "type" : "LARGE_AIRPORT",
      "elevation" : 13,
      "continent" : "NA",
      "countryCode" : "US",
      "region" : "US-NY",
      "localCode" : "JFK",
      "name" : "John F Kennedy International Airport",
      "iataCode" : "KJFK",
      "icaoCode" : "JFK",
      "city" : "New York",
      "country" : "US",
      "timezone" : "America/New_York",
      "ident" : "JFK",
      "lat" : 40.63980103,
      "lng" : -73.77890015
    },
    "passengerSTD" : "0730",
    "aircraftSTD" : "0730",
    "utcOffsetDepStation" : "-0500",
    "passengerDepartureTerminal" : "G",
    "arrivalStation" : {
      "type" : "LARGE_AIRPORT",
      "elevation" : 125,
      "continent" : "NA",
      "countryCode" : "US",
      "region" : "US-CA",
      "localCode" : "JFK",
      "name" : "Los Angeles International Airport",
      "iataCode" : "KLAX",
      "icaoCode" : "LAX",
      "city" : "Los Angeles",
      "country" : "US",
      "timezone" : "America/Los_Angeles",
      "ident" : "JFK",
      "lat" : 33.94250107,
      "lng" : -118.4079971
    },
    "aircraftSTA" : "1105",
    "passengerSTA" : "1105",
    "utcOffsetArrStation" : "-0700",
    "passengerArrivalTerminal" : "0",
    "aircraftType" : "32B",
    "prbd" : "FAJRDIYBHKMLGVSNQO",
    "prbm" : "N",
    "mealService" : {
      "mealServicePerClass" : [ {
        "passengerCode" : "F",
        "passengerClass" : "FirstClass",
        "mealService" : [ "Breakfast" ]
      }, {
        "passengerCode" : "J",
        "passengerClass" : "BusinessClassPremium",
        "mealService" : [ "Breakfast" ]
      }, {
        "passengerCode" : "Y",
        "passengerClass" : "EconomyOrCoach",
        "mealService" : [ "Snack or Brunch" ]
      }, {
        "passengerCode" : "V",
        "passengerClass" : "EconomyOrCoachDiscounted",
        "mealService" : [ "Snack or Brunch" ]
      } ]
    },
    "jointOperationAirline" : "AA",
    "minimumConnectingTime" : "0200",
    "secureFlightIndicator" : "S",
    "itineraryVariationIdentifierOverflow" : "2",
    "aircraftOwner" : "AA",
    "cockpitCrewEmployer" : "AA",
    "cabinCrewEmployer" : "AA",
    "onwardFlight" : {
      "airlineDesignator" : "AA",
      "flightNumber" : "1",
      "aircraftRotationLayover" : "0",
      "operationSuffix" : "A"
    },
    "flightTransitLayover" : "2",
    "operatingAirline" : "OPERATING_FLIGHT",
    "trafficRestrictionCode" : [ "O" ],
    "trafficRestrictionCodeLegOverflowIndication" : "Z",
    "aircraftVersion" : "A318",
    "departureDayDifference" : 0,
    "arrivalDayDifference" : 0,
    "recordSerialNumber" : "000003",
    "marketingCarriers" : [ {
      "airlineDesignator" : "TN",
      "flightNumber" : "1101",
      "flightOperator" : false
    } ],
    "inFlightServiceInformation" : [ {
      "service" : "Audio programming"
    }, {
      "service" : "Wi-Fi"
    }, {
      "service" : "In-seat Video Player/Library"
    }, {
      "service" : "USB Power"
    } ],
    "onTimePerformanceIndicator" : "80-89",
    "electronicTicketingCandidate" : "Y"
  } ],
  "continuationToken" : "Aw=="
}

Schedule By Departure, Arrival, Airline and Flight Number

Path parameters

Table 1. /{version}/route/departure/{departure}/arrival/{arrival}/airline/{airline}/flightNumber/{flightNumber}
Parameter	Description
`version`	The version of this API e.g. v1
`departure`	Valid IATA/ICAO departure Airport Code
`arrival`	Valid IATA/ICAO arrival Airport Code
`airline`	Valid IATA/ICAO Airline Code
`flightNumber`	Flight number

Request headers

Name	Description
`Content-Type`	The Content-Type of this request
`Authorization`	Authorization header that contains the access token.

Query parameters

Parameter	Description
`operationDateFrom`	Start Date for Operation Date Filter (Valid format is 'yyyy-MM-dd'). If not defined, current UTC date will be assigned
`operationDateTo`	End Date for Operation Date Filter (Valid format is 'yyyy-MM-dd'). If defined, operationDateFrom should also be present. If not defined, a 3 days window will be used based on operationDateFrom (if present) or the current UTC date.
`groupMarketingCarriers`	Group associated marketing and operating carrier flights into a single record. Default false.

Response fields

Path	Type	Description
`adi`	`String`	1-character direction indicator (A/D)
`airline`	`String`	2-character IATA or 3-character ICAO airline code
`arrival`	`String`	3-character IATA or 4-character ICAO arrival airport code
`continent`	`String`	2-character continent value
`continuationToken`	`String`	Indicates more results are available. Pass this value to the continuationToken parameter on the request to retrieve the next page
`country`	`String`	Country Name where airport is located
`departure`	`String`	3-character IATA or 4-character ICAO departure airport code
`flightNumber`	`String`	Flight number
`schedules[].aircraftOwner`	`String`	Aircraft owner
`schedules[].aircraftSTA`	`String`	Aircraft schedule time of arrival
`schedules[].aircraftSTD`	`String`	Aircraft scheduled time of departure
`schedules[].aircraftType`	`String`	Aircraft type
`schedules[].aircraftVersion`	`String`	Aircraft version
`schedules[].arrivalDayDifference`	`Number`	Arrival day difference
`schedules[].arrivalStation.city`	`String`	Arrival airport city
`schedules[].arrivalStation.continent`	`String`	Continent where airport is located
`schedules[].arrivalStation.country`	`String`	Arrival airport country
`schedules[].arrivalStation.countryCode`	`String`	Arrival airport country code
`schedules[].arrivalStation.elevation`	`Number`	Airport Elevation
`schedules[].arrivalStation.iataCode`	`String`	Arrival airport IATA code e.g JFK
`schedules[].arrivalStation.icaoCode`	`String`	Arrival airport ICAO code e.g KJFK
`schedules[].arrivalStation.ident`	`String`	Arrival airport ident
`schedules[].arrivalStation.lat`	`Number`	Arrival airport latitude position
`schedules[].arrivalStation.lng`	`Number`	Arrival airport longitude position
`schedules[].arrivalStation.localCode`	`String`	Arrival airport local code
`schedules[].arrivalStation.name`	`String`	Arrival airport full name
`schedules[].arrivalStation.region`	`String`	Arrival airport region
`schedules[].arrivalStation.timezone`	`String`	Arrival airport timezone
`schedules[].arrivalStation.type`	`String`	Arrival airport type e.g. LARGE_AIRPORT
`schedules[].cabinCrewEmployer`	`String`	Cabin crew employer
`schedules[].cockpitCrewEmployer`	`String`	Cockpit crew employer
`schedules[].daysOfOperation`	`Array`	Days of operation
`schedules[].departureDayDifference`	`Number`	Departure day difference
`schedules[].departureStation.city`	`String`	Departure airport city
`schedules[].departureStation.continent`	`String`	Departure airport continent
`schedules[].departureStation.country`	`String`	Departure airport country
`schedules[].departureStation.countryCode`	`String`	Departure airport country code
`schedules[].departureStation.elevation`	`Number`	Airport altitude
`schedules[].departureStation.iataCode`	`String`	Departure airport IATA code e.g JFK
`schedules[].departureStation.icaoCode`	`String`	Departure airport ICAO code e.g KJFK
`schedules[].departureStation.ident`	`String`	Departure airport identification
`schedules[].departureStation.lat`	`Number`	Departure airport latitude position
`schedules[].departureStation.lng`	`Number`	Departure airport longitude position
`schedules[].departureStation.localCode`	`String`	Departure airport local code
`schedules[].departureStation.name`	`String`	Departure airport full name
`schedules[].departureStation.region`	`String`	Departure airport region
`schedules[].departureStation.timezone`	`String`	Departure airport timezone
`schedules[].departureStation.type`	`String`	Departure airport type e.g. LARGE_AIRPORT
`schedules[].electronicTicketingCandidate`	`String`	Electronic ticketing candidate
`schedules[].flightTransitLayover`	`String`	Flight transit layover
`schedules[].frequencyRate`	`String`	Flight frequency rate
`schedules[].inFlightServiceInformation[].service`	`String`	Available in-flight service
`schedules[].itineraryVariationIdentifier`	`Number`	A number used to differentiate between itineraries with the same Flight Designator (excluding Operational Suffixes, if any)
`schedules[].itineraryVariationIdentifierOverflow`	`String`	Itinerary variation identifier
`schedules[].jointOperationAirline`	`String`	Joint operation airline
`schedules[].legSequenceNumber`	`Number`	Sequence number
`schedules[].marketingCarriers[].airlineDesignator`	`String`	Marketing airline code
`schedules[].marketingCarriers[].flightNumber`	`String`	Marketing airline flight number
`schedules[].marketingCarriers[].flightOperator`	`Boolean`	Indicates if the airline is the flight operator
`schedules[].mealService.mealServicePerClass[].mealService`	`Array`	Type of meal service e.g. Breakfast
`schedules[].mealService.mealServicePerClass[].passengerClass`	`String`	Passenger service class name e.g. BusinessClassPremium
`schedules[].mealService.mealServicePerClass[].passengerCode`	`String`	Passenger service class code e.g. A
`schedules[].minimumConnectingTime`	`String`	Minimum connecting time
`schedules[].onTimePerformanceIndicator`	`String`	On time performance indicator
`schedules[].onwardFlight.aircraftRotationLayover`	`String`	Aircraft rotation layover
`schedules[].onwardFlight.airlineDesignator`	`String`	Airline code of onward flight
`schedules[].onwardFlight.flightNumber`	`String`	Flight number of onward flight
`schedules[].onwardFlight.operationSuffix`	`String`	Flight suffix of onward flight e.g. 4A, 123B
`schedules[].operatingAirline`	`String`	Operating airline
`schedules[].operationBegin`	`String`	Operation begin date
`schedules[].operationEnd`	`String`	Operation end date
`schedules[].passengerArrivalTerminal`	`String`	Arrival terminal
`schedules[].passengerDepartureTerminal`	`String`	Departure terminal
`schedules[].passengerSTA`	`String`	Passenger schedule time of arrival
`schedules[].passengerSTD`	`String`	Passenger scheduled time of departure
`schedules[].prbd`	`String`	Passenger Reservations Booking Designator
`schedules[].prbm`	`String`	Passenger Reservations Booking Modifier
`schedules[].recordSerialNumber`	`String`	Record serial number
`schedules[].secureFlightIndicator`	`String`	Secure flight indicator
`schedules[].serviceType`	`String`	Service type
`schedules[].trafficRestrictionCode`	`Array`	Traffic restriction code
`schedules[].trafficRestrictionCodeLegOverflowIndication`	`String`	Traffic Restriction Code for flight leg
`schedules[].utcOffsetArrStation`	`String`	UTC offset at arrival airport
`schedules[].utcOffsetDepStation`	`String`	UTC offset at departure airport

Curl request

$ curl 'https://sitaopen.api.aero/schedule/v1/route/departure/JFK/arrival/LAX/airline/AA/flightNumber/1?operationDateFrom=2020-07-06&operationDateTo=2020-07-10&groupMarketingCarriers=true' -i -X GET \
    -H 'Authorization: Bearer eyJkb2N1bWVudGF0aW9uIiwidG9rZW4ifQ...' \
    -H 'Content-Type: application/json'

HTTP response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 3627
{
  "departure" : "JFK",
  "arrival" : "LAX",
  "airline" : "AA",
  "flightNumber" : "1",
  "adi" : "D",
  "continent" : "NA",
  "country" : "US",
  "schedules" : [ {
    "itineraryVariationIdentifier" : 1,
    "legSequenceNumber" : 1,
    "serviceType" : "J",
    "operationBegin" : "06JUL2020",
    "operationEnd" : "03JUL2021",
    "daysOfOperation" : [ "Monday", "Tuesday", "Thursday" ],
    "frequencyRate" : "2",
    "departureStation" : {
      "type" : "LARGE_AIRPORT",
      "elevation" : 13,
      "continent" : "NA",
      "countryCode" : "US",
      "region" : "US-NY",
      "localCode" : "JFK",
      "name" : "John F Kennedy International Airport",
      "iataCode" : "KJFK",
      "icaoCode" : "JFK",
      "city" : "New York",
      "country" : "US",
      "timezone" : "America/New_York",
      "ident" : "JFK",
      "lat" : 40.63980103,
      "lng" : -73.77890015
    },
    "passengerSTD" : "0730",
    "aircraftSTD" : "0730",
    "utcOffsetDepStation" : "-0500",
    "passengerDepartureTerminal" : "G",
    "arrivalStation" : {
      "type" : "LARGE_AIRPORT",
      "elevation" : 125,
      "continent" : "NA",
      "countryCode" : "US",
      "region" : "US-CA",
      "localCode" : "JFK",
      "name" : "Los Angeles International Airport",
      "iataCode" : "KLAX",
      "icaoCode" : "LAX",
      "city" : "Los Angeles",
      "country" : "US",
      "timezone" : "America/Los_Angeles",
      "ident" : "JFK",
      "lat" : 33.94250107,
      "lng" : -118.4079971
    },
    "aircraftSTA" : "1105",
    "passengerSTA" : "1105",
    "utcOffsetArrStation" : "-0700",
    "passengerArrivalTerminal" : "0",
    "aircraftType" : "32B",
    "prbd" : "FAJRDIYBHKMLGVSNQO",
    "prbm" : "N",
    "mealService" : {
      "mealServicePerClass" : [ {
        "passengerCode" : "F",
        "passengerClass" : "FirstClass",
        "mealService" : [ "Breakfast" ]
      }, {
        "passengerCode" : "J",
        "passengerClass" : "BusinessClassPremium",
        "mealService" : [ "Breakfast" ]
      }, {
        "passengerCode" : "Y",
        "passengerClass" : "EconomyOrCoach",
        "mealService" : [ "Snack or Brunch" ]
      }, {
        "passengerCode" : "V",
        "passengerClass" : "EconomyOrCoachDiscounted",
        "mealService" : [ "Snack or Brunch" ]
      } ]
    },
    "jointOperationAirline" : "AA",
    "minimumConnectingTime" : "0200",
    "secureFlightIndicator" : "S",
    "itineraryVariationIdentifierOverflow" : "2",
    "aircraftOwner" : "AA",
    "cockpitCrewEmployer" : "AA",
    "cabinCrewEmployer" : "AA",
    "onwardFlight" : {
      "airlineDesignator" : "AA",
      "flightNumber" : "1",
      "aircraftRotationLayover" : "0",
      "operationSuffix" : "A"
    },
    "flightTransitLayover" : "2",
    "operatingAirline" : "OPERATING_FLIGHT",
    "trafficRestrictionCode" : [ "O" ],
    "trafficRestrictionCodeLegOverflowIndication" : "Z",
    "aircraftVersion" : "A318",
    "departureDayDifference" : 0,
    "arrivalDayDifference" : 0,
    "recordSerialNumber" : "000003",
    "marketingCarriers" : [ {
      "airlineDesignator" : "TN",
      "flightNumber" : "1101",
      "flightOperator" : false
    } ],
    "inFlightServiceInformation" : [ {
      "service" : "Audio programming"
    }, {
      "service" : "Wi-Fi"
    }, {
      "service" : "In-seat Video Player/Library"
    }, {
      "service" : "USB Power"
    } ],
    "onTimePerformanceIndicator" : "80-89",
    "electronicTicketingCandidate" : "Y"
  } ],
  "continuationToken" : "Aw=="
}

Schedule By Airline

Path parameters

Table 1. /{version}/airline/{airline}
Parameter	Description
`version`	The version of this API e.g. v1
`airline`	Valid IATA/ICAO Airline Code

Request headers

Name	Description
`Content-Type`	The Content-Type of this request
`Authorization`	Authorization header that contains the access token.

Query parameters

Parameter	Description
`operationDateFrom`	Start Date for Operation Date Filter (Valid format is 'yyyy-MM-dd'). If not defined, current UTC date will be assigned
`operationDateTo`	End Date for Operation Date Filter (Valid format is 'yyyy-MM-dd'). If defined, operationDateFrom should also be present. If not defined, a 3 days window will be used based on operationDateFrom (if present) or the current UTC date.
`groupMarketingCarriers`	Group associated marketing and operating carrier flights into a single record. Default false.

Response fields

Path	Type	Description
`adi`	`String`	1-character direction indicator (A/D)
`airline`	`String`	2-character IATA or 3-character ICAO airline code
`arrival`	`String`	3-character IATA or 4-character ICAO arrival airport code
`continent`	`String`	2-character continent value
`continuationToken`	`String`	Indicates more results are available. Pass this value to the continuationToken parameter on the request to retrieve the next page
`country`	`String`	Country Name where airport is located
`departure`	`String`	3-character IATA or 4-character ICAO departure airport code
`flightNumber`	`String`	Flight number
`schedules[].aircraftOwner`	`String`	Aircraft owner
`schedules[].aircraftSTA`	`String`	Aircraft schedule time of arrival
`schedules[].aircraftSTD`	`String`	Aircraft scheduled time of departure
`schedules[].aircraftType`	`String`	Aircraft type
`schedules[].aircraftVersion`	`String`	Aircraft version
`schedules[].arrivalDayDifference`	`Number`	Arrival day difference
`schedules[].arrivalStation.city`	`String`	Arrival airport city
`schedules[].arrivalStation.continent`	`String`	Continent where airport is located
`schedules[].arrivalStation.country`	`String`	Arrival airport country
`schedules[].arrivalStation.countryCode`	`String`	Arrival airport country code
`schedules[].arrivalStation.elevation`	`Number`	Airport Elevation
`schedules[].arrivalStation.iataCode`	`String`	Arrival airport IATA code e.g JFK
`schedules[].arrivalStation.icaoCode`	`String`	Arrival airport ICAO code e.g KJFK
`schedules[].arrivalStation.ident`	`String`	Arrival airport ident
`schedules[].arrivalStation.lat`	`Number`	Arrival airport latitude position
`schedules[].arrivalStation.lng`	`Number`	Arrival airport longitude position
`schedules[].arrivalStation.localCode`	`String`	Arrival airport local code
`schedules[].arrivalStation.name`	`String`	Arrival airport full name
`schedules[].arrivalStation.region`	`String`	Arrival airport region
`schedules[].arrivalStation.timezone`	`String`	Arrival airport timezone
`schedules[].arrivalStation.type`	`String`	Arrival airport type e.g. LARGE_AIRPORT
`schedules[].cabinCrewEmployer`	`String`	Cabin crew employer
`schedules[].cockpitCrewEmployer`	`String`	Cockpit crew employer
`schedules[].daysOfOperation`	`Array`	Days of operation
`schedules[].departureDayDifference`	`Number`	Departure day difference
`schedules[].departureStation.city`	`String`	Departure airport city
`schedules[].departureStation.continent`	`String`	Departure airport continent
`schedules[].departureStation.country`	`String`	Departure airport country
`schedules[].departureStation.countryCode`	`String`	Departure airport country code
`schedules[].departureStation.elevation`	`Number`	Airport altitude
`schedules[].departureStation.iataCode`	`String`	Departure airport IATA code e.g JFK
`schedules[].departureStation.icaoCode`	`String`	Departure airport ICAO code e.g KJFK
`schedules[].departureStation.ident`	`String`	Departure airport identification
`schedules[].departureStation.lat`	`Number`	Departure airport latitude position
`schedules[].departureStation.lng`	`Number`	Departure airport longitude position
`schedules[].departureStation.localCode`	`String`	Departure airport local code
`schedules[].departureStation.name`	`String`	Departure airport full name
`schedules[].departureStation.region`	`String`	Departure airport region
`schedules[].departureStation.timezone`	`String`	Departure airport timezone
`schedules[].departureStation.type`	`String`	Departure airport type e.g. LARGE_AIRPORT
`schedules[].electronicTicketingCandidate`	`String`	Electronic ticketing candidate
`schedules[].flightTransitLayover`	`String`	Flight transit layover
`schedules[].frequencyRate`	`String`	Flight frequency rate
`schedules[].inFlightServiceInformation[].service`	`String`	Available in-flight service
`schedules[].itineraryVariationIdentifier`	`Number`	A number used to differentiate between itineraries with the same Flight Designator (excluding Operational Suffixes, if any)
`schedules[].itineraryVariationIdentifierOverflow`	`String`	Itinerary variation identifier
`schedules[].jointOperationAirline`	`String`	Joint operation airline
`schedules[].legSequenceNumber`	`Number`	Sequence number
`schedules[].marketingCarriers[].airlineDesignator`	`String`	Marketing airline code
`schedules[].marketingCarriers[].flightNumber`	`String`	Marketing airline flight number
`schedules[].marketingCarriers[].flightOperator`	`Boolean`	Indicates if the airline is the flight operator
`schedules[].mealService.mealServicePerClass[].mealService`	`Array`	Type of meal service e.g. Breakfast
`schedules[].mealService.mealServicePerClass[].passengerClass`	`String`	Passenger service class name e.g. BusinessClassPremium
`schedules[].mealService.mealServicePerClass[].passengerCode`	`String`	Passenger service class code e.g. A
`schedules[].minimumConnectingTime`	`String`	Minimum connecting time
`schedules[].onTimePerformanceIndicator`	`String`	On time performance indicator
`schedules[].onwardFlight.aircraftRotationLayover`	`String`	Aircraft rotation layover
`schedules[].onwardFlight.airlineDesignator`	`String`	Airline code of onward flight
`schedules[].onwardFlight.flightNumber`	`String`	Flight number of onward flight
`schedules[].onwardFlight.operationSuffix`	`String`	Flight suffix of onward flight e.g. 4A, 123B
`schedules[].operatingAirline`	`String`	Operating airline
`schedules[].operationBegin`	`String`	Operation begin date
`schedules[].operationEnd`	`String`	Operation end date
`schedules[].passengerArrivalTerminal`	`String`	Arrival terminal
`schedules[].passengerDepartureTerminal`	`String`	Departure terminal
`schedules[].passengerSTA`	`String`	Passenger schedule time of arrival
`schedules[].passengerSTD`	`String`	Passenger scheduled time of departure
`schedules[].prbd`	`String`	Passenger Reservations Booking Designator
`schedules[].prbm`	`String`	Passenger Reservations Booking Modifier
`schedules[].recordSerialNumber`	`String`	Record serial number
`schedules[].secureFlightIndicator`	`String`	Secure flight indicator
`schedules[].serviceType`	`String`	Service type
`schedules[].trafficRestrictionCode`	`Array`	Traffic restriction code
`schedules[].trafficRestrictionCodeLegOverflowIndication`	`String`	Traffic Restriction Code for flight leg
`schedules[].utcOffsetArrStation`	`String`	UTC offset at arrival airport
`schedules[].utcOffsetDepStation`	`String`	UTC offset at departure airport

Curl request

$ curl 'https://sitaopen.api.aero/schedule/v1/airline/AA?operationDateFrom=2020-07-06&operationDateTo=2020-07-10&groupMarketingCarriers=true' -i -X GET \
    -H 'Authorization: Bearer eyJkb2N1bWVudGF0aW9uIiwidG9rZW4ifQ...' \
    -H 'Content-Type: application/json'

HTTP response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 3556
{
  "airline" : "AA",
  "adi" : "D",
  "continent" : "NA",
  "country" : "US",
  "schedules" : [ {
    "itineraryVariationIdentifier" : 1,
    "legSequenceNumber" : 1,
    "serviceType" : "J",
    "operationBegin" : "06JUL2020",
    "operationEnd" : "03JUL2021",
    "daysOfOperation" : [ "Monday", "Tuesday", "Thursday" ],
    "frequencyRate" : "2",
    "departureStation" : {
      "type" : "LARGE_AIRPORT",
      "elevation" : 13,
      "continent" : "NA",
      "countryCode" : "US",
      "region" : "US-NY",
      "localCode" : "JFK",
      "name" : "John F Kennedy International Airport",
      "iataCode" : "KJFK",
      "icaoCode" : "JFK",
      "city" : "New York",
      "country" : "US",
      "timezone" : "America/New_York",
      "ident" : "JFK",
      "lat" : 40.63980103,
      "lng" : -73.77890015
    },
    "passengerSTD" : "0730",
    "aircraftSTD" : "0730",
    "utcOffsetDepStation" : "-0500",
    "passengerDepartureTerminal" : "G",
    "arrivalStation" : {
      "type" : "LARGE_AIRPORT",
      "elevation" : 125,
      "continent" : "NA",
      "countryCode" : "US",
      "region" : "US-CA",
      "localCode" : "JFK",
      "name" : "Los Angeles International Airport",
      "iataCode" : "KLAX",
      "icaoCode" : "LAX",
      "city" : "Los Angeles",
      "country" : "US",
      "timezone" : "America/Los_Angeles",
      "ident" : "JFK",
      "lat" : 33.94250107,
      "lng" : -118.4079971
    },
    "aircraftSTA" : "1105",
    "passengerSTA" : "1105",
    "utcOffsetArrStation" : "-0700",
    "passengerArrivalTerminal" : "0",
    "aircraftType" : "32B",
    "prbd" : "FAJRDIYBHKMLGVSNQO",
    "prbm" : "N",
    "mealService" : {
      "mealServicePerClass" : [ {
        "passengerCode" : "F",
        "passengerClass" : "FirstClass",
        "mealService" : [ "Breakfast" ]
      }, {
        "passengerCode" : "J",
        "passengerClass" : "BusinessClassPremium",
        "mealService" : [ "Breakfast" ]
      }, {
        "passengerCode" : "Y",
        "passengerClass" : "EconomyOrCoach",
        "mealService" : [ "Snack or Brunch" ]
      }, {
        "passengerCode" : "V",
        "passengerClass" : "EconomyOrCoachDiscounted",
        "mealService" : [ "Snack or Brunch" ]
      } ]
    },
    "jointOperationAirline" : "AA",
    "minimumConnectingTime" : "0200",
    "secureFlightIndicator" : "S",
    "itineraryVariationIdentifierOverflow" : "2",
    "aircraftOwner" : "AA",
    "cockpitCrewEmployer" : "AA",
    "cabinCrewEmployer" : "AA",
    "onwardFlight" : {
      "airlineDesignator" : "AA",
      "flightNumber" : "1",
      "aircraftRotationLayover" : "0",
      "operationSuffix" : "A"
    },
    "flightTransitLayover" : "2",
    "operatingAirline" : "OPERATING_FLIGHT",
    "trafficRestrictionCode" : [ "O" ],
    "trafficRestrictionCodeLegOverflowIndication" : "Z",
    "aircraftVersion" : "A318",
    "departureDayDifference" : 0,
    "arrivalDayDifference" : 0,
    "recordSerialNumber" : "000003",
    "marketingCarriers" : [ {
      "airlineDesignator" : "TN",
      "flightNumber" : "1101",
      "flightOperator" : false
    } ],
    "inFlightServiceInformation" : [ {
      "service" : "Audio programming"
    }, {
      "service" : "Wi-Fi"
    }, {
      "service" : "In-seat Video Player/Library"
    }, {
      "service" : "USB Power"
    } ],
    "onTimePerformanceIndicator" : "80-89",
    "electronicTicketingCandidate" : "Y"
  } ],
  "continuationToken" : "Aw=="
}

Schedule By Airline and Flight Number

Path parameters

Table 1. /{version}/airline/{airline}/flightNumber/{flightNumber}
Parameter	Description
`version`	The version of this API e.g. v1
`airline`	Valid IATA/ICAO Airline Code
`flightNumber`	Flight number

Request headers

Name	Description
`Content-Type`	The Content-Type of this request
`Authorization`	Authorization header that contains the access token.

Query parameters

Parameter	Description
`operationDateFrom`	Start Date for Operation Date Filter (Valid format is 'yyyy-MM-dd'). If not defined, current UTC date will be assigned
`operationDateTo`	End Date for Operation Date Filter (Valid format is 'yyyy-MM-dd'). If defined, operationDateFrom should also be present. If not defined, a 3 days window will be used based on operationDateFrom (if present) or the current UTC date.
`groupMarketingCarriers`	Group associated marketing and operating carrier flights into a single record. Default false.

Response fields

Path	Type	Description
`adi`	`String`	1-character direction indicator (A/D)
`airline`	`String`	2-character IATA or 3-character ICAO airline code
`arrival`	`String`	3-character IATA or 4-character ICAO arrival airport code
`continent`	`String`	2-character continent value
`continuationToken`	`String`	Indicates more results are available. Pass this value to the continuationToken parameter on the request to retrieve the next page
`country`	`String`	Country Name where airport is located
`departure`	`String`	3-character IATA or 4-character ICAO departure airport code
`flightNumber`	`String`	Flight number
`schedules[].aircraftOwner`	`String`	Aircraft owner
`schedules[].aircraftSTA`	`String`	Aircraft schedule time of arrival
`schedules[].aircraftSTD`	`String`	Aircraft scheduled time of departure
`schedules[].aircraftType`	`String`	Aircraft type
`schedules[].aircraftVersion`	`String`	Aircraft version
`schedules[].arrivalDayDifference`	`Number`	Arrival day difference
`schedules[].arrivalStation.city`	`String`	Arrival airport city
`schedules[].arrivalStation.continent`	`String`	Continent where airport is located
`schedules[].arrivalStation.country`	`String`	Arrival airport country
`schedules[].arrivalStation.countryCode`	`String`	Arrival airport country code
`schedules[].arrivalStation.elevation`	`Number`	Airport Elevation
`schedules[].arrivalStation.iataCode`	`String`	Arrival airport IATA code e.g JFK
`schedules[].arrivalStation.icaoCode`	`String`	Arrival airport ICAO code e.g KJFK
`schedules[].arrivalStation.ident`	`String`	Arrival airport ident
`schedules[].arrivalStation.lat`	`Number`	Arrival airport latitude position
`schedules[].arrivalStation.lng`	`Number`	Arrival airport longitude position
`schedules[].arrivalStation.localCode`	`String`	Arrival airport local code
`schedules[].arrivalStation.name`	`String`	Arrival airport full name
`schedules[].arrivalStation.region`	`String`	Arrival airport region
`schedules[].arrivalStation.timezone`	`String`	Arrival airport timezone
`schedules[].arrivalStation.type`	`String`	Arrival airport type e.g. LARGE_AIRPORT
`schedules[].cabinCrewEmployer`	`String`	Cabin crew employer
`schedules[].cockpitCrewEmployer`	`String`	Cockpit crew employer
`schedules[].daysOfOperation`	`Array`	Days of operation
`schedules[].departureDayDifference`	`Number`	Departure day difference
`schedules[].departureStation.city`	`String`	Departure airport city
`schedules[].departureStation.continent`	`String`	Departure airport continent
`schedules[].departureStation.country`	`String`	Departure airport country
`schedules[].departureStation.countryCode`	`String`	Departure airport country code
`schedules[].departureStation.elevation`	`Number`	Airport altitude
`schedules[].departureStation.iataCode`	`String`	Departure airport IATA code e.g JFK
`schedules[].departureStation.icaoCode`	`String`	Departure airport ICAO code e.g KJFK
`schedules[].departureStation.ident`	`String`	Departure airport identification
`schedules[].departureStation.lat`	`Number`	Departure airport latitude position
`schedules[].departureStation.lng`	`Number`	Departure airport longitude position
`schedules[].departureStation.localCode`	`String`	Departure airport local code
`schedules[].departureStation.name`	`String`	Departure airport full name
`schedules[].departureStation.region`	`String`	Departure airport region
`schedules[].departureStation.timezone`	`String`	Departure airport timezone
`schedules[].departureStation.type`	`String`	Departure airport type e.g. LARGE_AIRPORT
`schedules[].electronicTicketingCandidate`	`String`	Electronic ticketing candidate
`schedules[].flightTransitLayover`	`String`	Flight transit layover
`schedules[].frequencyRate`	`String`	Flight frequency rate
`schedules[].inFlightServiceInformation[].service`	`String`	Available in-flight service
`schedules[].itineraryVariationIdentifier`	`Number`	A number used to differentiate between itineraries with the same Flight Designator (excluding Operational Suffixes, if any)
`schedules[].itineraryVariationIdentifierOverflow`	`String`	Itinerary variation identifier
`schedules[].jointOperationAirline`	`String`	Joint operation airline
`schedules[].legSequenceNumber`	`Number`	Sequence number
`schedules[].marketingCarriers[].airlineDesignator`	`String`	Marketing airline code
`schedules[].marketingCarriers[].flightNumber`	`String`	Marketing airline flight number
`schedules[].marketingCarriers[].flightOperator`	`Boolean`	Indicates if the airline is the flight operator
`schedules[].mealService.mealServicePerClass[].mealService`	`Array`	Type of meal service e.g. Breakfast
`schedules[].mealService.mealServicePerClass[].passengerClass`	`String`	Passenger service class name e.g. BusinessClassPremium
`schedules[].mealService.mealServicePerClass[].passengerCode`	`String`	Passenger service class code e.g. A
`schedules[].minimumConnectingTime`	`String`	Minimum connecting time
`schedules[].onTimePerformanceIndicator`	`String`	On time performance indicator
`schedules[].onwardFlight.aircraftRotationLayover`	`String`	Aircraft rotation layover
`schedules[].onwardFlight.airlineDesignator`	`String`	Airline code of onward flight
`schedules[].onwardFlight.flightNumber`	`String`	Flight number of onward flight
`schedules[].onwardFlight.operationSuffix`	`String`	Flight suffix of onward flight e.g. 4A, 123B
`schedules[].operatingAirline`	`String`	Operating airline
`schedules[].operationBegin`	`String`	Operation begin date
`schedules[].operationEnd`	`String`	Operation end date
`schedules[].passengerArrivalTerminal`	`String`	Arrival terminal
`schedules[].passengerDepartureTerminal`	`String`	Departure terminal
`schedules[].passengerSTA`	`String`	Passenger schedule time of arrival
`schedules[].passengerSTD`	`String`	Passenger scheduled time of departure
`schedules[].prbd`	`String`	Passenger Reservations Booking Designator
`schedules[].prbm`	`String`	Passenger Reservations Booking Modifier
`schedules[].recordSerialNumber`	`String`	Record serial number
`schedules[].secureFlightIndicator`	`String`	Secure flight indicator
`schedules[].serviceType`	`String`	Service type
`schedules[].trafficRestrictionCode`	`Array`	Traffic restriction code
`schedules[].trafficRestrictionCodeLegOverflowIndication`	`String`	Traffic Restriction Code for flight leg
`schedules[].utcOffsetArrStation`	`String`	UTC offset at arrival airport
`schedules[].utcOffsetDepStation`	`String`	UTC offset at departure airport

Curl request

$ curl 'https://sitaopen.api.aero/schedule/v1/airline/AA/flightNumber/1?operationDateFrom=2020-07-06&operationDateTo=2020-07-10&groupMarketingCarriers=true' -i -X GET \
    -H 'Authorization: Bearer eyJkb2N1bWVudGF0aW9uIiwidG9rZW4ifQ...' \
    -H 'Content-Type: application/json'

HTTP response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 3581
{
  "airline" : "AA",
  "flightNumber" : "1",
  "adi" : "D",
  "continent" : "NA",
  "country" : "US",
  "schedules" : [ {
    "itineraryVariationIdentifier" : 1,
    "legSequenceNumber" : 1,
    "serviceType" : "J",
    "operationBegin" : "06JUL2020",
    "operationEnd" : "03JUL2021",
    "daysOfOperation" : [ "Monday", "Tuesday", "Thursday" ],
    "frequencyRate" : "2",
    "departureStation" : {
      "type" : "LARGE_AIRPORT",
      "elevation" : 13,
      "continent" : "NA",
      "countryCode" : "US",
      "region" : "US-NY",
      "localCode" : "JFK",
      "name" : "John F Kennedy International Airport",
      "iataCode" : "KJFK",
      "icaoCode" : "JFK",
      "city" : "New York",
      "country" : "US",
      "timezone" : "America/New_York",
      "ident" : "JFK",
      "lat" : 40.63980103,
      "lng" : -73.77890015
    },
    "passengerSTD" : "0730",
    "aircraftSTD" : "0730",
    "utcOffsetDepStation" : "-0500",
    "passengerDepartureTerminal" : "G",
    "arrivalStation" : {
      "type" : "LARGE_AIRPORT",
      "elevation" : 125,
      "continent" : "NA",
      "countryCode" : "US",
      "region" : "US-CA",
      "localCode" : "JFK",
      "name" : "Los Angeles International Airport",
      "iataCode" : "KLAX",
      "icaoCode" : "LAX",
      "city" : "Los Angeles",
      "country" : "US",
      "timezone" : "America/Los_Angeles",
      "ident" : "JFK",
      "lat" : 33.94250107,
      "lng" : -118.4079971
    },
    "aircraftSTA" : "1105",
    "passengerSTA" : "1105",
    "utcOffsetArrStation" : "-0700",
    "passengerArrivalTerminal" : "0",
    "aircraftType" : "32B",
    "prbd" : "FAJRDIYBHKMLGVSNQO",
    "prbm" : "N",
    "mealService" : {
      "mealServicePerClass" : [ {
        "passengerCode" : "F",
        "passengerClass" : "FirstClass",
        "mealService" : [ "Breakfast" ]
      }, {
        "passengerCode" : "J",
        "passengerClass" : "BusinessClassPremium",
        "mealService" : [ "Breakfast" ]
      }, {
        "passengerCode" : "Y",
        "passengerClass" : "EconomyOrCoach",
        "mealService" : [ "Snack or Brunch" ]
      }, {
        "passengerCode" : "V",
        "passengerClass" : "EconomyOrCoachDiscounted",
        "mealService" : [ "Snack or Brunch" ]
      } ]
    },
    "jointOperationAirline" : "AA",
    "minimumConnectingTime" : "0200",
    "secureFlightIndicator" : "S",
    "itineraryVariationIdentifierOverflow" : "2",
    "aircraftOwner" : "AA",
    "cockpitCrewEmployer" : "AA",
    "cabinCrewEmployer" : "AA",
    "onwardFlight" : {
      "airlineDesignator" : "AA",
      "flightNumber" : "1",
      "aircraftRotationLayover" : "0",
      "operationSuffix" : "A"
    },
    "flightTransitLayover" : "2",
    "operatingAirline" : "OPERATING_FLIGHT",
    "trafficRestrictionCode" : [ "O" ],
    "trafficRestrictionCodeLegOverflowIndication" : "Z",
    "aircraftVersion" : "A318",
    "departureDayDifference" : 0,
    "arrivalDayDifference" : 0,
    "recordSerialNumber" : "000003",
    "marketingCarriers" : [ {
      "airlineDesignator" : "TN",
      "flightNumber" : "1101",
      "flightOperator" : false
    } ],
    "inFlightServiceInformation" : [ {
      "service" : "Audio programming"
    }, {
      "service" : "Wi-Fi"
    }, {
      "service" : "In-seat Video Player/Library"
    }, {
      "service" : "USB Power"
    } ],
    "onTimePerformanceIndicator" : "80-89",
    "electronicTicketingCandidate" : "Y"
  } ],
  "continuationToken" : "Aw=="
}

Schedule By Airport and ADI

Path parameters

Table 1. /{version}/airport/{airport}/direction/{adi}
Parameter	Description
`version`	The version of this API e.g. v1
`adi`	1-character direction indicator (A/D)
`airport`	Valid IATA/ICAO departure or arrival Airport Code

Request headers

Name	Description
`Content-Type`	The Content-Type of this request
`Authorization`	Authorization header that contains the access token.

Query parameters

Parameter	Description
`operationDateFrom`	Start Date for Operation Date Filter (Valid format is 'yyyy-MM-dd'). If not defined, current UTC date will be assigned
`operationDateTo`	End Date for Operation Date Filter (Valid format is 'yyyy-MM-dd'). If defined, operationDateFrom should also be present. If not defined, a 3 days window will be used based on operationDateFrom (if present) or the current UTC date.
`groupMarketingCarriers`	Group associated marketing and operating carrier flights into a single record. Default false.

Response fields

Path	Type	Description
`adi`	`String`	1-character direction indicator (A/D)
`airline`	`String`	2-character IATA or 3-character ICAO airline code
`arrival`	`String`	3-character IATA or 4-character ICAO arrival airport code
`continent`	`String`	2-character continent value
`continuationToken`	`String`	Indicates more results are available. Pass this value to the continuationToken parameter on the request to retrieve the next page
`country`	`String`	Country Name where airport is located
`departure`	`String`	3-character IATA or 4-character ICAO departure airport code
`flightNumber`	`String`	Flight number
`schedules[].aircraftOwner`	`String`	Aircraft owner
`schedules[].aircraftSTA`	`String`	Aircraft schedule time of arrival
`schedules[].aircraftSTD`	`String`	Aircraft scheduled time of departure
`schedules[].aircraftType`	`String`	Aircraft type
`schedules[].aircraftVersion`	`String`	Aircraft version
`schedules[].arrivalDayDifference`	`Number`	Arrival day difference
`schedules[].arrivalStation.city`	`String`	Arrival airport city
`schedules[].arrivalStation.continent`	`String`	Continent where airport is located
`schedules[].arrivalStation.country`	`String`	Arrival airport country
`schedules[].arrivalStation.countryCode`	`String`	Arrival airport country code
`schedules[].arrivalStation.elevation`	`Number`	Airport Elevation
`schedules[].arrivalStation.iataCode`	`String`	Arrival airport IATA code e.g JFK
`schedules[].arrivalStation.icaoCode`	`String`	Arrival airport ICAO code e.g KJFK
`schedules[].arrivalStation.ident`	`String`	Arrival airport ident
`schedules[].arrivalStation.lat`	`Number`	Arrival airport latitude position
`schedules[].arrivalStation.lng`	`Number`	Arrival airport longitude position
`schedules[].arrivalStation.localCode`	`String`	Arrival airport local code
`schedules[].arrivalStation.name`	`String`	Arrival airport full name
`schedules[].arrivalStation.region`	`String`	Arrival airport region
`schedules[].arrivalStation.timezone`	`String`	Arrival airport timezone
`schedules[].arrivalStation.type`	`String`	Arrival airport type e.g. LARGE_AIRPORT
`schedules[].cabinCrewEmployer`	`String`	Cabin crew employer
`schedules[].cockpitCrewEmployer`	`String`	Cockpit crew employer
`schedules[].daysOfOperation`	`Array`	Days of operation
`schedules[].departureDayDifference`	`Number`	Departure day difference
`schedules[].departureStation.city`	`String`	Departure airport city
`schedules[].departureStation.continent`	`String`	Departure airport continent
`schedules[].departureStation.country`	`String`	Departure airport country
`schedules[].departureStation.countryCode`	`String`	Departure airport country code
`schedules[].departureStation.elevation`	`Number`	Airport altitude
`schedules[].departureStation.iataCode`	`String`	Departure airport IATA code e.g JFK
`schedules[].departureStation.icaoCode`	`String`	Departure airport ICAO code e.g KJFK
`schedules[].departureStation.ident`	`String`	Departure airport identification
`schedules[].departureStation.lat`	`Number`	Departure airport latitude position
`schedules[].departureStation.lng`	`Number`	Departure airport longitude position
`schedules[].departureStation.localCode`	`String`	Departure airport local code
`schedules[].departureStation.name`	`String`	Departure airport full name
`schedules[].departureStation.region`	`String`	Departure airport region
`schedules[].departureStation.timezone`	`String`	Departure airport timezone
`schedules[].departureStation.type`	`String`	Departure airport type e.g. LARGE_AIRPORT
`schedules[].electronicTicketingCandidate`	`String`	Electronic ticketing candidate
`schedules[].flightTransitLayover`	`String`	Flight transit layover
`schedules[].frequencyRate`	`String`	Flight frequency rate
`schedules[].inFlightServiceInformation[].service`	`String`	Available in-flight service
`schedules[].itineraryVariationIdentifier`	`Number`	A number used to differentiate between itineraries with the same Flight Designator (excluding Operational Suffixes, if any)
`schedules[].itineraryVariationIdentifierOverflow`	`String`	Itinerary variation identifier
`schedules[].jointOperationAirline`	`String`	Joint operation airline
`schedules[].legSequenceNumber`	`Number`	Sequence number
`schedules[].marketingCarriers[].airlineDesignator`	`String`	Marketing airline code
`schedules[].marketingCarriers[].flightNumber`	`String`	Marketing airline flight number
`schedules[].marketingCarriers[].flightOperator`	`Boolean`	Indicates if the airline is the flight operator
`schedules[].mealService.mealServicePerClass[].mealService`	`Array`	Type of meal service e.g. Breakfast
`schedules[].mealService.mealServicePerClass[].passengerClass`	`String`	Passenger service class name e.g. BusinessClassPremium
`schedules[].mealService.mealServicePerClass[].passengerCode`	`String`	Passenger service class code e.g. A
`schedules[].minimumConnectingTime`	`String`	Minimum connecting time
`schedules[].onTimePerformanceIndicator`	`String`	On time performance indicator
`schedules[].onwardFlight.aircraftRotationLayover`	`String`	Aircraft rotation layover
`schedules[].onwardFlight.airlineDesignator`	`String`	Airline code of onward flight
`schedules[].onwardFlight.flightNumber`	`String`	Flight number of onward flight
`schedules[].onwardFlight.operationSuffix`	`String`	Flight suffix of onward flight e.g. 4A, 123B
`schedules[].operatingAirline`	`String`	Operating airline
`schedules[].operationBegin`	`String`	Operation begin date
`schedules[].operationEnd`	`String`	Operation end date
`schedules[].passengerArrivalTerminal`	`String`	Arrival terminal
`schedules[].passengerDepartureTerminal`	`String`	Departure terminal
`schedules[].passengerSTA`	`String`	Passenger schedule time of arrival
`schedules[].passengerSTD`	`String`	Passenger scheduled time of departure
`schedules[].prbd`	`String`	Passenger Reservations Booking Designator
`schedules[].prbm`	`String`	Passenger Reservations Booking Modifier
`schedules[].recordSerialNumber`	`String`	Record serial number
`schedules[].secureFlightIndicator`	`String`	Secure flight indicator
`schedules[].serviceType`	`String`	Service type
`schedules[].trafficRestrictionCode`	`Array`	Traffic restriction code
`schedules[].trafficRestrictionCodeLegOverflowIndication`	`String`	Traffic Restriction Code for flight leg
`schedules[].utcOffsetArrStation`	`String`	UTC offset at arrival airport
`schedules[].utcOffsetDepStation`	`String`	UTC offset at departure airport

Curl request

$ curl 'https://sitaopen.api.aero/schedule/v1/airport/JFK/direction/D?operationDateFrom=2020-07-06&operationDateTo=2020-07-10&groupMarketingCarriers=true' -i -X GET \
    -H 'Authorization: Bearer eyJkb2N1bWVudGF0aW9uIiwidG9rZW4ifQ...' \
    -H 'Content-Type: application/json'

HTTP response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 3581
{
  "departure" : "JFK",
  "arrival" : "LAX",
  "adi" : "D",
  "continent" : "NA",
  "country" : "US",
  "schedules" : [ {
    "itineraryVariationIdentifier" : 1,
    "legSequenceNumber" : 1,
    "serviceType" : "J",
    "operationBegin" : "06JUL2020",
    "operationEnd" : "03JUL2021",
    "daysOfOperation" : [ "Monday", "Tuesday", "Thursday" ],
    "frequencyRate" : "2",
    "departureStation" : {
      "type" : "LARGE_AIRPORT",
      "elevation" : 13,
      "continent" : "NA",
      "countryCode" : "US",
      "region" : "US-NY",
      "localCode" : "JFK",
      "name" : "John F Kennedy International Airport",
      "iataCode" : "KJFK",
      "icaoCode" : "JFK",
      "city" : "New York",
      "country" : "US",
      "timezone" : "America/New_York",
      "ident" : "JFK",
      "lat" : 40.63980103,
      "lng" : -73.77890015
    },
    "passengerSTD" : "0730",
    "aircraftSTD" : "0730",
    "utcOffsetDepStation" : "-0500",
    "passengerDepartureTerminal" : "G",
    "arrivalStation" : {
      "type" : "LARGE_AIRPORT",
      "elevation" : 125,
      "continent" : "NA",
      "countryCode" : "US",
      "region" : "US-CA",
      "localCode" : "JFK",
      "name" : "Los Angeles International Airport",
      "iataCode" : "KLAX",
      "icaoCode" : "LAX",
      "city" : "Los Angeles",
      "country" : "US",
      "timezone" : "America/Los_Angeles",
      "ident" : "JFK",
      "lat" : 33.94250107,
      "lng" : -118.4079971
    },
    "aircraftSTA" : "1105",
    "passengerSTA" : "1105",
    "utcOffsetArrStation" : "-0700",
    "passengerArrivalTerminal" : "0",
    "aircraftType" : "32B",
    "prbd" : "FAJRDIYBHKMLGVSNQO",
    "prbm" : "N",
    "mealService" : {
      "mealServicePerClass" : [ {
        "passengerCode" : "F",
        "passengerClass" : "FirstClass",
        "mealService" : [ "Breakfast" ]
      }, {
        "passengerCode" : "J",
        "passengerClass" : "BusinessClassPremium",
        "mealService" : [ "Breakfast" ]
      }, {
        "passengerCode" : "Y",
        "passengerClass" : "EconomyOrCoach",
        "mealService" : [ "Snack or Brunch" ]
      }, {
        "passengerCode" : "V",
        "passengerClass" : "EconomyOrCoachDiscounted",
        "mealService" : [ "Snack or Brunch" ]
      } ]
    },
    "jointOperationAirline" : "AA",
    "minimumConnectingTime" : "0200",
    "secureFlightIndicator" : "S",
    "itineraryVariationIdentifierOverflow" : "2",
    "aircraftOwner" : "AA",
    "cockpitCrewEmployer" : "AA",
    "cabinCrewEmployer" : "AA",
    "onwardFlight" : {
      "airlineDesignator" : "AA",
      "flightNumber" : "1",
      "aircraftRotationLayover" : "0",
      "operationSuffix" : "A"
    },
    "flightTransitLayover" : "2",
    "operatingAirline" : "OPERATING_FLIGHT",
    "trafficRestrictionCode" : [ "O" ],
    "trafficRestrictionCodeLegOverflowIndication" : "Z",
    "aircraftVersion" : "A318",
    "departureDayDifference" : 0,
    "arrivalDayDifference" : 0,
    "recordSerialNumber" : "000003",
    "marketingCarriers" : [ {
      "airlineDesignator" : "TN",
      "flightNumber" : "1101",
      "flightOperator" : false
    } ],
    "inFlightServiceInformation" : [ {
      "service" : "Audio programming"
    }, {
      "service" : "Wi-Fi"
    }, {
      "service" : "In-seat Video Player/Library"
    }, {
      "service" : "USB Power"
    } ],
    "onTimePerformanceIndicator" : "80-89",
    "electronicTicketingCandidate" : "Y"
  } ],
  "continuationToken" : "Aw=="
}

Error Response

Response fields

Path	Type	Description
`errors`	`Object`	Object that holds the error information
`errors.error[]`	`Array`	Array of errors
`errors.error[].code`	`Number`	Schedule API Internal Error Code
`errors.error[].description`	`String`	Error Description
`errors.error[].invalidParam`	`String`	Indicates the invalid query parameter
`errors.error[].invalidValue`	`String`	Indicates the invalid query parameter value

Curl request

$ curl 'https://sitaopen.api.aero/schedule/v1/route/departure/JFK/arrival/LAX?operationDateFrom=2022-07-30&operationDateTo=2022-07-31&groupMarketingCarriers=true&pageSize=-1' -i -X GET \
    -H 'Authorization: Bearer eyJkb2N1bWVudGF0aW9uIiwidG9rZW4ifQ...' \
    -H 'Content-Type: application/json'

HTTP response

HTTP/1.1 400 Bad Request
Content-Type: application/json
Content-Length: 209
{
  "errors" : {
    "error" : [ {
      "description" : "Invalid page size.",
      "code" : 2028,
      "invalidParam" : "pageSize",
      "invalidValue" : "Please contact API Support"
    } ]
  }
}

Appendix A Flight Schedule Use Cases

Scenario:	As an API user I want to make a request to the Schedule API to return all flights for a specific departure airport, to a specific arrival airport for a certain timeframe
Request:	GET /schedule/v1/route/departure/JFK/arrival/LAX?operationDateFrom=2022-10-17&operationDateTo=2022-10-24
Response:	List of flight records for JFK departure flights arriving in LAX between October 17th and October 24th 2022

Scenario:	As an API user I want to make a request to the Schedule API to return all departures for a chosen airport on a specific date
Request:	GET /schedule/v1/airport/JFK/direction/D?operationDateFrom=2022-10-17&operationDateTo=2022-10-24
Response:	List of flight records for flights departing JFK between October 17th and October 24th 2022

Scenario:	As an API user I want to make a request to the Schedule API to return all arrivals for a chosen airport on a specific date
Request:	GET /schedule/v1/airport/JFK/direction/A?operationDateFrom=2022-10-17&operationDateTo=2022-10-24
Response:	List of flight records for flights arriving in JFK between October 17th and October 24th 2022

Appendix B Flight Schedule Service Type Codes

Code	Description	Application	Content
`F`	`Loose Loaded cargo and/or preloaded devices`	`Scheduled`	`Cargo/Mail`
`M`	`Mail only`	`Scheduled`	`Cargo/Mail`
`H`	`Cargo and/or Mail`	`Charter`	`Cargo/Mail`
`V`	`Service operated by Surface Vehicle`	`Scheduled`	`Cargo/Mail`
`A`	`Cargo/Mail`	`Additional Flights`	`Cargo/Mail`
`W`	`Military`	`Others`	`Not Specific`
`E`	`Special (FAA/Government)`	`Others`	`Not Specific`
`D`	`General Aviation, non-commercial (e.g. school training) and empty flights`	`General Aviation`	`Not Specific`
`N`	`Business Aviation/Air Taxi`	`Business Aviation`	`Not Specific`
`I`	`State/Diplomatic (Chapter 6 only)`	`Others`	`Not Specific`
`X`	`Technical Stop (for Chapter 6 applications only)`	`Others`	`Not Specific`
`K`	`Crew training (other than GABA operators)`	`Others`	`Not Specific`
`T`	`Technical Test`	`Others`	`Not Specific`
`P`	`Non-revenue (Positioning/Ferry/Delivery/Demo)`	`Others`	`Not Specific`
`J`	`Normal Service`	`Scheduled`	`Passenger`
`C`	`Passenger Only`	`Charter`	`Passenger`
`B`	`Shuttle Mode`	`Additional Flights`	`Passenger`
`G`	`Normal Service`	`Additional Flights`	`Passenger`
`S`	`Shuttle Mode`	`Scheduled`	`Passenger`
`U`	`Service operated by Surface Vehicle Chapter 6 only-Air Ambulance/Humanitarian`	`Scheduled`	`Passenger Non-specific`
`R`	`Passenger/Cargo in Cabin (mixed configuration aircraft)`	`Additional Flights`	`Passenger/Cargo`
`Q`	`Passenger/Cargo in Cabin (mixed configuration aircraft)`	`Scheduled`	`Passenger/Cargo`
`L`	`Passenger and Cargo and/or Mail`	`Charter`	`Passenger/Cargo/Mail`
`O`	`Charter requiring special handling (e.g., Migrants/immigrant Flights)`	`Charter`	`Special Handling`

Version 1.2.0-SNAPSHOT

Contact Us

For subscription and sales queries, please contact:

Product Inquiries

For Flight Schedule API related queries, please contact:

Technical Support Team

Overview

Who uses it

Technical Documentation

1 Revision History

Registration and API Signup

Flight Schedule API

Schedule By Departure and Arrival Stations

Schedule By Departure, Arrival and Airline

Schedule By Departure, Arrival, Airline and Flight Number

Schedule By Airline

Schedule By Airline and Flight Number

Schedule By Airport and ADI

Error Response

Appendix A Flight Schedule Use Cases

Appendix B Flight Schedule Service Type Codes

Contact Us

For subscription and sales queries, please contact:

For Flight Schedule API related queries, please contact:

About us