Flight Schedule Overview

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.

SITA Flight Schedule API

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`
`08 November 2024`	`1.5`	`Added Full/Multi Leg Schedules APIs`

Registration and API Signup

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"

2.2.1 SITA Flight Schedule API Structure

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.`
`/airline/{airline}/flightNumber/{flightNumber}/departure/{airportCode}`	`GET`	`Returns all active linked flight schedules for an Airline/Flight number/Departure both single and multi-leg flights.`

2.2.2 SITA Flight Enhanced Schedule API Structure

Function	Method	Description
`/enhanced/airline/{airline}/flightNumber/{flightNumber}`	`GET`	`Returns all active flight schedules for Airline with Flight Number within the From and To Dates`
`/enhanced/airline/{airline}/flightNumber/{flightNumber}/direction/{adi}/airport/{airportCode}`	`GET`	`Returns all active flight schedules for Airline with Flight Number Arriving or Departing an Airport within the From and To Dates`

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`	The scheduled departure time of an aircraft from the terminal or departure gate/position at an airport
`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[].flightRouteDetails[].arrivalAirport`	`String`	Arrival airport on this route
`schedules[].flightRouteDetails[].departureAirport`	`String`	Departure airport on this route
`schedules[].flightRouteDetails[].legSequenceNumber`	`Number`	Indicates the position where this leg operates on a route, corresponds with legSequenceNumber on payload
`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[].operatingAirlineDisclosureCode`	`String`	Operating airline disclosure code
`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`	The scheduled time of departure of the passenger at the terminal or departure gate at an airport”.
`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: 3767

{
  "adi" : "D",
  "arrival" : "LAX",
  "continent" : "NA",
  "continuationToken" : "Aw==",
  "country" : "US",
  "departure" : "JFK",
  "schedules" : [ {
    "itineraryVariationIdentifier" : 1,
    "legSequenceNumber" : 1,
    "serviceType" : "J",
    "operationBegin" : "06JUL2020",
    "operationEnd" : "03JUL2021",
    "daysOfOperation" : [ "Monday", "Tuesday", "Thursday" ],
    "frequencyRate" : "2",
    "departureStation" : {
      "ident" : "JFK",
      "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",
      "lat" : 40.63980103,
      "lng" : -73.77890015,
      "country" : "US",
      "timezone" : "America/New_York"
    },
    "passengerSTD" : "0730",
    "aircraftSTD" : "0730",
    "utcOffsetDepStation" : "-0500",
    "passengerDepartureTerminal" : "G",
    "arrivalStation" : {
      "ident" : "JFK",
      "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",
      "lat" : 33.94250107,
      "lng" : -118.4079971,
      "country" : "US",
      "timezone" : "America/Los_Angeles"
    },
    "aircraftSTA" : "1105",
    "passengerSTA" : "1105",
    "utcOffsetArrStation" : "-0700",
    "passengerArrivalTerminal" : "0",
    "aircraftType" : "32B",
    "prbd" : "FAJRDIYBHKMLGVSNQO",
    "prbm" : "N",
    "mealService" : {
      "mealServicePerClass" : [ {
        "mealService" : [ "Breakfast" ],
        "passengerClass" : "FirstClass",
        "passengerCode" : "F"
      }, {
        "mealService" : [ "Breakfast" ],
        "passengerClass" : "BusinessClassPremium",
        "passengerCode" : "J"
      }, {
        "mealService" : [ "Snack or Brunch" ],
        "passengerClass" : "EconomyOrCoach",
        "passengerCode" : "Y"
      }, {
        "mealService" : [ "Snack or Brunch" ],
        "passengerClass" : "EconomyOrCoachDiscounted",
        "passengerCode" : "V"
      } ]
    },
    "jointOperationAirline" : "AA",
    "minimumConnectingTime" : "0200",
    "secureFlightIndicator" : "S",
    "itineraryVariationIdentifierOverflow" : "2",
    "aircraftOwner" : "AA",
    "cockpitCrewEmployer" : "AA",
    "cabinCrewEmployer" : "AA",
    "onwardFlight" : {
      "aircraftRotationLayover" : "0",
      "airlineDesignator" : "AA",
      "flightNumber" : "1",
      "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",
    "operatingAirlineDisclosureCode" : "X",
    "flightRouteDetails" : [ {
      "departureAirport" : "JFK",
      "arrivalAirport" : "LAX",
      "legSequenceNumber" : 1
    } ]
  } ]
}

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`	The scheduled departure time of an aircraft from the terminal or departure gate/position at an airport
`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[].flightRouteDetails[].arrivalAirport`	`String`	Arrival airport on this route
`schedules[].flightRouteDetails[].departureAirport`	`String`	Departure airport on this route
`schedules[].flightRouteDetails[].legSequenceNumber`	`Number`	Indicates the position where this leg operates on a route, corresponds with legSequenceNumber on payload
`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[].operatingAirlineDisclosureCode`	`String`	Operating airline disclosure code
`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`	The scheduled time of departure of the passenger at the terminal or departure gate at an airport”.
`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: 3788

{
  "adi" : "D",
  "airline" : "AA",
  "arrival" : "LAX",
  "continent" : "NA",
  "continuationToken" : "Aw==",
  "country" : "US",
  "departure" : "JFK",
  "schedules" : [ {
    "itineraryVariationIdentifier" : 1,
    "legSequenceNumber" : 1,
    "serviceType" : "J",
    "operationBegin" : "06JUL2020",
    "operationEnd" : "03JUL2021",
    "daysOfOperation" : [ "Monday", "Tuesday", "Thursday" ],
    "frequencyRate" : "2",
    "departureStation" : {
      "ident" : "JFK",
      "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",
      "lat" : 40.63980103,
      "lng" : -73.77890015,
      "country" : "US",
      "timezone" : "America/New_York"
    },
    "passengerSTD" : "0730",
    "aircraftSTD" : "0730",
    "utcOffsetDepStation" : "-0500",
    "passengerDepartureTerminal" : "G",
    "arrivalStation" : {
      "ident" : "JFK",
      "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",
      "lat" : 33.94250107,
      "lng" : -118.4079971,
      "country" : "US",
      "timezone" : "America/Los_Angeles"
    },
    "aircraftSTA" : "1105",
    "passengerSTA" : "1105",
    "utcOffsetArrStation" : "-0700",
    "passengerArrivalTerminal" : "0",
    "aircraftType" : "32B",
    "prbd" : "FAJRDIYBHKMLGVSNQO",
    "prbm" : "N",
    "mealService" : {
      "mealServicePerClass" : [ {
        "mealService" : [ "Breakfast" ],
        "passengerClass" : "FirstClass",
        "passengerCode" : "F"
      }, {
        "mealService" : [ "Breakfast" ],
        "passengerClass" : "BusinessClassPremium",
        "passengerCode" : "J"
      }, {
        "mealService" : [ "Snack or Brunch" ],
        "passengerClass" : "EconomyOrCoach",
        "passengerCode" : "Y"
      }, {
        "mealService" : [ "Snack or Brunch" ],
        "passengerClass" : "EconomyOrCoachDiscounted",
        "passengerCode" : "V"
      } ]
    },
    "jointOperationAirline" : "AA",
    "minimumConnectingTime" : "0200",
    "secureFlightIndicator" : "S",
    "itineraryVariationIdentifierOverflow" : "2",
    "aircraftOwner" : "AA",
    "cockpitCrewEmployer" : "AA",
    "cabinCrewEmployer" : "AA",
    "onwardFlight" : {
      "aircraftRotationLayover" : "0",
      "airlineDesignator" : "AA",
      "flightNumber" : "1",
      "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",
    "operatingAirlineDisclosureCode" : "X",
    "flightRouteDetails" : [ {
      "departureAirport" : "JFK",
      "arrivalAirport" : "LAX",
      "legSequenceNumber" : 1
    } ]
  } ]
}

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`	The scheduled departure time of an aircraft from the terminal or departure gate/position at an airport
`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[].flightRouteDetails[].arrivalAirport`	`String`	Arrival airport on this route
`schedules[].flightRouteDetails[].departureAirport`	`String`	Departure airport on this route
`schedules[].flightRouteDetails[].legSequenceNumber`	`Number`	Indicates the position where this leg operates on a route, corresponds with legSequenceNumber on payload
`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[].operatingAirlineDisclosureCode`	`String`	Operating airline disclosure code
`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`	The scheduled time of departure of the passenger at the terminal or departure gate at an airport”.
`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: 3813

{
  "adi" : "D",
  "airline" : "AA",
  "arrival" : "LAX",
  "continent" : "NA",
  "continuationToken" : "Aw==",
  "country" : "US",
  "departure" : "JFK",
  "flightNumber" : "1",
  "schedules" : [ {
    "itineraryVariationIdentifier" : 1,
    "legSequenceNumber" : 1,
    "serviceType" : "J",
    "operationBegin" : "06JUL2020",
    "operationEnd" : "03JUL2021",
    "daysOfOperation" : [ "Monday", "Tuesday", "Thursday" ],
    "frequencyRate" : "2",
    "departureStation" : {
      "ident" : "JFK",
      "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",
      "lat" : 40.63980103,
      "lng" : -73.77890015,
      "country" : "US",
      "timezone" : "America/New_York"
    },
    "passengerSTD" : "0730",
    "aircraftSTD" : "0730",
    "utcOffsetDepStation" : "-0500",
    "passengerDepartureTerminal" : "G",
    "arrivalStation" : {
      "ident" : "JFK",
      "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",
      "lat" : 33.94250107,
      "lng" : -118.4079971,
      "country" : "US",
      "timezone" : "America/Los_Angeles"
    },
    "aircraftSTA" : "1105",
    "passengerSTA" : "1105",
    "utcOffsetArrStation" : "-0700",
    "passengerArrivalTerminal" : "0",
    "aircraftType" : "32B",
    "prbd" : "FAJRDIYBHKMLGVSNQO",
    "prbm" : "N",
    "mealService" : {
      "mealServicePerClass" : [ {
        "mealService" : [ "Breakfast" ],
        "passengerClass" : "FirstClass",
        "passengerCode" : "F"
      }, {
        "mealService" : [ "Breakfast" ],
        "passengerClass" : "BusinessClassPremium",
        "passengerCode" : "J"
      }, {
        "mealService" : [ "Snack or Brunch" ],
        "passengerClass" : "EconomyOrCoach",
        "passengerCode" : "Y"
      }, {
        "mealService" : [ "Snack or Brunch" ],
        "passengerClass" : "EconomyOrCoachDiscounted",
        "passengerCode" : "V"
      } ]
    },
    "jointOperationAirline" : "AA",
    "minimumConnectingTime" : "0200",
    "secureFlightIndicator" : "S",
    "itineraryVariationIdentifierOverflow" : "2",
    "aircraftOwner" : "AA",
    "cockpitCrewEmployer" : "AA",
    "cabinCrewEmployer" : "AA",
    "onwardFlight" : {
      "aircraftRotationLayover" : "0",
      "airlineDesignator" : "AA",
      "flightNumber" : "1",
      "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",
    "operatingAirlineDisclosureCode" : "X",
    "flightRouteDetails" : [ {
      "departureAirport" : "JFK",
      "arrivalAirport" : "LAX",
      "legSequenceNumber" : 1
    } ]
  } ]
}

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`	The scheduled departure time of an aircraft from the terminal or departure gate/position at an airport
`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[].flightRouteDetails[].arrivalAirport`	`String`	Arrival airport on this route
`schedules[].flightRouteDetails[].departureAirport`	`String`	Departure airport on this route
`schedules[].flightRouteDetails[].legSequenceNumber`	`Number`	Indicates the position where this leg operates on a route, corresponds with legSequenceNumber on payload
`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[].operatingAirlineDisclosureCode`	`String`	Operating airline disclosure code
`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`	The scheduled time of departure of the passenger at the terminal or departure gate at an airport”.
`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: 3742

{
  "adi" : "D",
  "airline" : "AA",
  "continent" : "NA",
  "continuationToken" : "Aw==",
  "country" : "US",
  "schedules" : [ {
    "itineraryVariationIdentifier" : 1,
    "legSequenceNumber" : 1,
    "serviceType" : "J",
    "operationBegin" : "06JUL2020",
    "operationEnd" : "03JUL2021",
    "daysOfOperation" : [ "Monday", "Tuesday", "Thursday" ],
    "frequencyRate" : "2",
    "departureStation" : {
      "ident" : "JFK",
      "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",
      "lat" : 40.63980103,
      "lng" : -73.77890015,
      "country" : "US",
      "timezone" : "America/New_York"
    },
    "passengerSTD" : "0730",
    "aircraftSTD" : "0730",
    "utcOffsetDepStation" : "-0500",
    "passengerDepartureTerminal" : "G",
    "arrivalStation" : {
      "ident" : "JFK",
      "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",
      "lat" : 33.94250107,
      "lng" : -118.4079971,
      "country" : "US",
      "timezone" : "America/Los_Angeles"
    },
    "aircraftSTA" : "1105",
    "passengerSTA" : "1105",
    "utcOffsetArrStation" : "-0700",
    "passengerArrivalTerminal" : "0",
    "aircraftType" : "32B",
    "prbd" : "FAJRDIYBHKMLGVSNQO",
    "prbm" : "N",
    "mealService" : {
      "mealServicePerClass" : [ {
        "mealService" : [ "Breakfast" ],
        "passengerClass" : "FirstClass",
        "passengerCode" : "F"
      }, {
        "mealService" : [ "Breakfast" ],
        "passengerClass" : "BusinessClassPremium",
        "passengerCode" : "J"
      }, {
        "mealService" : [ "Snack or Brunch" ],
        "passengerClass" : "EconomyOrCoach",
        "passengerCode" : "Y"
      }, {
        "mealService" : [ "Snack or Brunch" ],
        "passengerClass" : "EconomyOrCoachDiscounted",
        "passengerCode" : "V"
      } ]
    },
    "jointOperationAirline" : "AA",
    "minimumConnectingTime" : "0200",
    "secureFlightIndicator" : "S",
    "itineraryVariationIdentifierOverflow" : "2",
    "aircraftOwner" : "AA",
    "cockpitCrewEmployer" : "AA",
    "cabinCrewEmployer" : "AA",
    "onwardFlight" : {
      "aircraftRotationLayover" : "0",
      "airlineDesignator" : "AA",
      "flightNumber" : "1",
      "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",
    "operatingAirlineDisclosureCode" : "X",
    "flightRouteDetails" : [ {
      "departureAirport" : "JFK",
      "arrivalAirport" : "LAX",
      "legSequenceNumber" : 1
    } ]
  } ]
}

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`	The scheduled departure time of an aircraft from the terminal or departure gate/position at an airport
`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[].flightRouteDetails[].arrivalAirport`	`String`	Arrival airport on this route
`schedules[].flightRouteDetails[].departureAirport`	`String`	Departure airport on this route
`schedules[].flightRouteDetails[].legSequenceNumber`	`Number`	Indicates the position where this leg operates on a route, corresponds with legSequenceNumber on payload
`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[].operatingAirlineDisclosureCode`	`String`	Operating airline disclosure code
`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`	The scheduled time of departure of the passenger at the terminal or departure gate at an airport”.
`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: 3767

{
  "adi" : "D",
  "airline" : "AA",
  "continent" : "NA",
  "continuationToken" : "Aw==",
  "country" : "US",
  "flightNumber" : "1",
  "schedules" : [ {
    "itineraryVariationIdentifier" : 1,
    "legSequenceNumber" : 1,
    "serviceType" : "J",
    "operationBegin" : "06JUL2020",
    "operationEnd" : "03JUL2021",
    "daysOfOperation" : [ "Monday", "Tuesday", "Thursday" ],
    "frequencyRate" : "2",
    "departureStation" : {
      "ident" : "JFK",
      "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",
      "lat" : 40.63980103,
      "lng" : -73.77890015,
      "country" : "US",
      "timezone" : "America/New_York"
    },
    "passengerSTD" : "0730",
    "aircraftSTD" : "0730",
    "utcOffsetDepStation" : "-0500",
    "passengerDepartureTerminal" : "G",
    "arrivalStation" : {
      "ident" : "JFK",
      "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",
      "lat" : 33.94250107,
      "lng" : -118.4079971,
      "country" : "US",
      "timezone" : "America/Los_Angeles"
    },
    "aircraftSTA" : "1105",
    "passengerSTA" : "1105",
    "utcOffsetArrStation" : "-0700",
    "passengerArrivalTerminal" : "0",
    "aircraftType" : "32B",
    "prbd" : "FAJRDIYBHKMLGVSNQO",
    "prbm" : "N",
    "mealService" : {
      "mealServicePerClass" : [ {
        "mealService" : [ "Breakfast" ],
        "passengerClass" : "FirstClass",
        "passengerCode" : "F"
      }, {
        "mealService" : [ "Breakfast" ],
        "passengerClass" : "BusinessClassPremium",
        "passengerCode" : "J"
      }, {
        "mealService" : [ "Snack or Brunch" ],
        "passengerClass" : "EconomyOrCoach",
        "passengerCode" : "Y"
      }, {
        "mealService" : [ "Snack or Brunch" ],
        "passengerClass" : "EconomyOrCoachDiscounted",
        "passengerCode" : "V"
      } ]
    },
    "jointOperationAirline" : "AA",
    "minimumConnectingTime" : "0200",
    "secureFlightIndicator" : "S",
    "itineraryVariationIdentifierOverflow" : "2",
    "aircraftOwner" : "AA",
    "cockpitCrewEmployer" : "AA",
    "cabinCrewEmployer" : "AA",
    "onwardFlight" : {
      "aircraftRotationLayover" : "0",
      "airlineDesignator" : "AA",
      "flightNumber" : "1",
      "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",
    "operatingAirlineDisclosureCode" : "X",
    "flightRouteDetails" : [ {
      "departureAirport" : "JFK",
      "arrivalAirport" : "LAX",
      "legSequenceNumber" : 1
    } ]
  } ]
}

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`	The scheduled departure time of an aircraft from the terminal or departure gate/position at an airport
`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[].flightRouteDetails[].arrivalAirport`	`String`	Arrival airport on this route
`schedules[].flightRouteDetails[].departureAirport`	`String`	Departure airport on this route
`schedules[].flightRouteDetails[].legSequenceNumber`	`Number`	Indicates the position where this leg operates on a route, corresponds with legSequenceNumber on payload
`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[].operatingAirlineDisclosureCode`	`String`	Operating airline disclosure code
`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`	The scheduled time of departure of the passenger at the terminal or departure gate at an airport”.
`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: 3767

{
  "adi" : "D",
  "arrival" : "LAX",
  "continent" : "NA",
  "continuationToken" : "Aw==",
  "country" : "US",
  "departure" : "JFK",
  "schedules" : [ {
    "itineraryVariationIdentifier" : 1,
    "legSequenceNumber" : 1,
    "serviceType" : "J",
    "operationBegin" : "06JUL2020",
    "operationEnd" : "03JUL2021",
    "daysOfOperation" : [ "Monday", "Tuesday", "Thursday" ],
    "frequencyRate" : "2",
    "departureStation" : {
      "ident" : "JFK",
      "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",
      "lat" : 40.63980103,
      "lng" : -73.77890015,
      "country" : "US",
      "timezone" : "America/New_York"
    },
    "passengerSTD" : "0730",
    "aircraftSTD" : "0730",
    "utcOffsetDepStation" : "-0500",
    "passengerDepartureTerminal" : "G",
    "arrivalStation" : {
      "ident" : "JFK",
      "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",
      "lat" : 33.94250107,
      "lng" : -118.4079971,
      "country" : "US",
      "timezone" : "America/Los_Angeles"
    },
    "aircraftSTA" : "1105",
    "passengerSTA" : "1105",
    "utcOffsetArrStation" : "-0700",
    "passengerArrivalTerminal" : "0",
    "aircraftType" : "32B",
    "prbd" : "FAJRDIYBHKMLGVSNQO",
    "prbm" : "N",
    "mealService" : {
      "mealServicePerClass" : [ {
        "mealService" : [ "Breakfast" ],
        "passengerClass" : "FirstClass",
        "passengerCode" : "F"
      }, {
        "mealService" : [ "Breakfast" ],
        "passengerClass" : "BusinessClassPremium",
        "passengerCode" : "J"
      }, {
        "mealService" : [ "Snack or Brunch" ],
        "passengerClass" : "EconomyOrCoach",
        "passengerCode" : "Y"
      }, {
        "mealService" : [ "Snack or Brunch" ],
        "passengerClass" : "EconomyOrCoachDiscounted",
        "passengerCode" : "V"
      } ]
    },
    "jointOperationAirline" : "AA",
    "minimumConnectingTime" : "0200",
    "secureFlightIndicator" : "S",
    "itineraryVariationIdentifierOverflow" : "2",
    "aircraftOwner" : "AA",
    "cockpitCrewEmployer" : "AA",
    "cabinCrewEmployer" : "AA",
    "onwardFlight" : {
      "aircraftRotationLayover" : "0",
      "airlineDesignator" : "AA",
      "flightNumber" : "1",
      "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",
    "operatingAirlineDisclosureCode" : "X",
    "flightRouteDetails" : [ {
      "departureAirport" : "JFK",
      "arrivalAirport" : "LAX",
      "legSequenceNumber" : 1
    } ]
  } ]
}

3.1.7 Schedule By Airline and Flight Number, Departure, From and To

Path parameters

Table 1. /{version}/airline/{airline}/flightNumber/{flightNumber}/departure/{departure}
Parameter	Description
`version`	The version of this API e.g. v1
`airline`	Valid IATA/ICAO Airline Code
`flightNumber`	Flight number
`departure`	Valid IATA/ICAO departure 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
`airline`	`String`	2-character IATA or 3-character ICAO airline code
`arrival`	`String`	3-character IATA or 4-character ICAO arrival airport code
`departure`	`String`	3-character IATA or 4-character ICAO departure airport code
`flightNumber`	`String`	Flight number
`fullSchedules[].airline`	`String`	2-character IATA or 3-character ICAO airline code
`fullSchedules[].arrival`	`String`	3-character IATA or 4-character ICAO arrival airport code
`fullSchedules[].departure`	`String`	3-character IATA or 4-character ICAO departure airport code
`fullSchedules[].flightLegs[].aircraftOwner`	`String`	Aircraft owner
`fullSchedules[].flightLegs[].aircraftSTA`	`String`	Aircraft schedule time of arrival
`fullSchedules[].flightLegs[].aircraftSTD`	`String`	The scheduled departure time of an aircraft from the terminal or departure gate/position at an airport
`fullSchedules[].flightLegs[].aircraftType`	`String`	Aircraft type
`fullSchedules[].flightLegs[].aircraftVersion`	`String`	Aircraft version
`fullSchedules[].flightLegs[].arrivalDayDifference`	`Number`	Arrival day difference
`fullSchedules[].flightLegs[].arrivalStation.city`	`String`	Arrival airport city
`fullSchedules[].flightLegs[].arrivalStation.continent`	`String`	Continent where airport is located
`fullSchedules[].flightLegs[].arrivalStation.country`	`String`	Arrival airport country
`fullSchedules[].flightLegs[].arrivalStation.countryCode`	`String`	Arrival airport country code
`fullSchedules[].flightLegs[].arrivalStation.elevation`	`Number`	Airport Elevation
`fullSchedules[].flightLegs[].arrivalStation.iataCode`	`String`	Arrival airport IATA code e.g JFK
`fullSchedules[].flightLegs[].arrivalStation.icaoCode`	`String`	Arrival airport ICAO code e.g KJFK
`fullSchedules[].flightLegs[].arrivalStation.ident`	`String`	Arrival airport ident
`fullSchedules[].flightLegs[].arrivalStation.lat`	`Number`	Arrival airport latitude position
`fullSchedules[].flightLegs[].arrivalStation.lng`	`Number`	Arrival airport longitude position
`fullSchedules[].flightLegs[].arrivalStation.localCode`	`String`	Arrival airport local code
`fullSchedules[].flightLegs[].arrivalStation.name`	`String`	Arrival airport full name
`fullSchedules[].flightLegs[].arrivalStation.region`	`String`	Arrival airport region
`fullSchedules[].flightLegs[].arrivalStation.timezone`	`String`	Arrival airport timezone
`fullSchedules[].flightLegs[].arrivalStation.type`	`String`	Arrival airport type e.g. LARGE_AIRPORT
`fullSchedules[].flightLegs[].cabinCrewEmployer`	`String`	Cabin crew employer
`fullSchedules[].flightLegs[].cockpitCrewEmployer`	`String`	Cockpit crew employer
`fullSchedules[].flightLegs[].daysOfOperation`	`Array`	Days of operation
`fullSchedules[].flightLegs[].departureDayDifference`	`Number`	Departure day difference
`fullSchedules[].flightLegs[].departureStation.city`	`String`	Departure airport city
`fullSchedules[].flightLegs[].departureStation.continent`	`String`	Departure airport continent
`fullSchedules[].flightLegs[].departureStation.country`	`String`	Departure airport country
`fullSchedules[].flightLegs[].departureStation.countryCode`	`String`	Departure airport country code
`fullSchedules[].flightLegs[].departureStation.elevation`	`Number`	Airport altitude
`fullSchedules[].flightLegs[].departureStation.iataCode`	`String`	Departure airport IATA code e.g JFK
`fullSchedules[].flightLegs[].departureStation.icaoCode`	`String`	Departure airport ICAO code e.g KJFK
`fullSchedules[].flightLegs[].departureStation.ident`	`String`	Departure airport identification
`fullSchedules[].flightLegs[].departureStation.lat`	`Number`	Departure airport latitude position
`fullSchedules[].flightLegs[].departureStation.lng`	`Number`	Departure airport longitude position
`fullSchedules[].flightLegs[].departureStation.localCode`	`String`	Departure airport local code
`fullSchedules[].flightLegs[].departureStation.name`	`String`	Departure airport full name
`fullSchedules[].flightLegs[].departureStation.region`	`String`	Departure airport region
`fullSchedules[].flightLegs[].departureStation.timezone`	`String`	Departure airport timezone
`fullSchedules[].flightLegs[].departureStation.type`	`String`	Departure airport type e.g. LARGE_AIRPORT
`fullSchedules[].flightLegs[].electronicTicketingCandidate`	`String`	Electronic ticketing candidate
`fullSchedules[].flightLegs[].flightDesignator.airlineDesignator`	`String`	2-character IATA or 3-character ICAO airline code
`fullSchedules[].flightLegs[].flightDesignator.flightNumber`	`String`	Flight number
`fullSchedules[].flightLegs[].flightDesignator.flightOperator`	`Boolean`	A boolean
`fullSchedules[].flightLegs[].flightRouteDetails[].arrivalAirport`	`String`	Arrival airport on this route
`fullSchedules[].flightLegs[].flightRouteDetails[].departureAirport`	`String`	Departure airport on this route
`fullSchedules[].flightLegs[].flightRouteDetails[].legSequenceNumber`	`Number`	Indicates the position where this leg operates on a route, corresponds with legSequenceNumber on payload
`fullSchedules[].flightLegs[].flightTransitLayover`	`String`	Flight transit layover
`fullSchedules[].flightLegs[].frequencyRate`	`String`	Flight frequency rate
`fullSchedules[].flightLegs[].inFlightServiceInformation[].service`	`String`	Available in-flight service
`fullSchedules[].flightLegs[].itineraryVariationIdentifier`	`Number`	A number used to differentiate between itineraries with the same Flight Designator (excluding Operational Suffixes, if any)
`fullSchedules[].flightLegs[].itineraryVariationIdentifierOverflow`	`String`	Itinerary variation identifier
`fullSchedules[].flightLegs[].jointOperationAirline`	`String`	Joint operation airline
`fullSchedules[].flightLegs[].legSequenceNumber`	`Number`	Sequence number
`fullSchedules[].flightLegs[].marketingCarriers[].airlineDesignator`	`String`	Marketing airline code
`fullSchedules[].flightLegs[].marketingCarriers[].flightNumber`	`String`	Marketing airline flight number
`fullSchedules[].flightLegs[].marketingCarriers[].flightOperator`	`Boolean`	Indicates if the airline is the flight operator
`fullSchedules[].flightLegs[].mealService.mealServicePerClass[].mealService`	`Array`	Type of meal service e.g. Breakfast
`fullSchedules[].flightLegs[].mealService.mealServicePerClass[].passengerClass`	`String`	Passenger service class name e.g. BusinessClassPremium
`fullSchedules[].flightLegs[].mealService.mealServicePerClass[].passengerCode`	`String`	Passenger service class code e.g. A
`fullSchedules[].flightLegs[].minimumConnectingTime`	`String`	Minimum connecting time
`fullSchedules[].flightLegs[].onTimePerformanceIndicator`	`String`	On time performance indicator
`fullSchedules[].flightLegs[].onwardFlight`	`Object`	Onward flight details
`fullSchedules[].flightLegs[].onwardFlight.aircraftRotationLayover`	`String`	Aircraft rotation layover
`fullSchedules[].flightLegs[].onwardFlight.airlineDesignator`	`String`	Airline code of onward flight
`fullSchedules[].flightLegs[].onwardFlight.flightNumber`	`String`	Flight number of onward flight
`fullSchedules[].flightLegs[].onwardFlight.operationSuffix`	`String`	Flight suffix of onward flight e.g. 4A, 123B
`fullSchedules[].flightLegs[].operatingAirline`	`String`	Operating airline
`fullSchedules[].flightLegs[].operatingAirlineDisclosureCode`	`String`	Operating airline disclosure code
`fullSchedules[].flightLegs[].operationBegin`	`String`	Operation begin date
`fullSchedules[].flightLegs[].operationEnd`	`String`	Operation end date
`fullSchedules[].flightLegs[].passengerArrivalTerminal`	`String`	Arrival terminal
`fullSchedules[].flightLegs[].passengerDepartureTerminal`	`String`	Departure terminal
`fullSchedules[].flightLegs[].passengerSTA`	`String`	Passenger schedule time of arrival
`fullSchedules[].flightLegs[].passengerSTD`	`String`	The scheduled time of departure of the passenger at the terminal or departure gate at an airport”.
`fullSchedules[].flightLegs[].prbd`	`String`	Passenger Reservations Booking Designator
`fullSchedules[].flightLegs[].prbm`	`String`	Passenger Reservations Booking Modifier
`fullSchedules[].flightLegs[].recordSerialNumber`	`String`	Record serial number
`fullSchedules[].flightLegs[].secureFlightIndicator`	`String`	Secure flight indicator
`fullSchedules[].flightLegs[].serviceType`	`String`	Service type
`fullSchedules[].flightLegs[].trafficRestrictionCode`	`String`	Traffic restriction code
`fullSchedules[].flightLegs[].trafficRestrictionCodeLegOverflowIndication`	`String`	Traffic Restriction Code for flight leg
`fullSchedules[].flightLegs[].utcOffsetArrStation`	`String`	UTC offset at arrival airport
`fullSchedules[].flightLegs[].utcOffsetDepStation`	`String`	UTC offset at departure airport
`fullSchedules[].flightNumber`	`String`	Flight number
`fullSchedules[].itineraryVariationIdentifier`	`Number`	A number used to differentiate between itineraries with the same Flight Designator (excluding Operational Suffixes, if any)
`operationDate`	`String`	Query period.
`operationDateFrom`	`String`	Start date of query period.
`operationDateTo`	`String`	End date of query period.

Curl request

$ curl 'https://sitaopen.api.aero/schedule/v1/airline/BA/flightNumber/15/departure/LHR?operationDateFrom=2024-11-27&operationDateTo=2024-11-27&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: 11805

{
  "airline" : "BA",
  "departure" : "LHR",
  "flightNumber" : "15",
  "fullSchedules" : [ {
    "arrival" : "SYD",
    "departure" : "LHR",
    "flightLegs" : [ {
      "flightDesignator" : {
        "airlineDesignator" : "BA",
        "flightNumber" : "15",
        "flightOperator" : true
      },
      "itineraryVariationIdentifier" : 1,
      "legSequenceNumber" : 1,
      "serviceType" : "J",
      "operationBegin" : "25NOV2024",
      "operationEnd" : "28MAR2025",
      "daysOfOperation" : [ "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday", "Sunday" ],
      "departureStation" : {
        "type" : "LARGE_AIRPORT",
        "elevation" : 83,
        "continent" : "EU",
        "countryCode" : "GB",
        "region" : "GB-ENG",
        "name" : "London Heathrow Airport",
        "iataCode" : "LHR",
        "icaoCode" : "EGLL",
        "city" : "London",
        "lat" : 51.4706,
        "lng" : -0.461941,
        "timezone" : "Europe/London"
      },
      "passengerSTD" : "2110",
      "aircraftSTD" : "2110",
      "utcOffsetDepStation" : "+0000",
      "passengerDepartureTerminal" : "5",
      "arrivalStation" : {
        "type" : "LARGE_AIRPORT",
        "elevation" : 22,
        "continent" : "AS",
        "countryCode" : "SG",
        "region" : "SG-04",
        "name" : "Singapore Changi Airport",
        "iataCode" : "SIN",
        "icaoCode" : "WSSS",
        "city" : "Singapore",
        "lat" : 1.35019,
        "lng" : 103.994003,
        "timezone" : "Asia/Singapore"
      },
      "aircraftSTA" : "1825",
      "passengerSTA" : "1825",
      "utcOffsetArrStation" : "+0800",
      "passengerArrivalTerminal" : "1",
      "aircraftType" : "77W",
      "prbd" : "FAJCDRIWETYBHKMLVSNQOG",
      "mealService" : {
        "mealServicePerClass" : [ {
          "mealService" : [ "Meal" ],
          "passengerClass" : "FirstClass",
          "passengerCode" : "F"
        }, {
          "mealService" : [ "Meal" ],
          "passengerClass" : "FirstClassDiscounted",
          "passengerCode" : "A"
        }, {
          "mealService" : [ "Meal" ],
          "passengerClass" : "BusinessClassPremium",
          "passengerCode" : "J"
        }, {
          "mealService" : [ "Meal" ],
          "passengerClass" : "BusinessClass",
          "passengerCode" : "C"
        }, {
          "mealService" : [ "Meal" ],
          "passengerClass" : "BusinessClassDiscounted",
          "passengerCode" : "D"
        }, {
          "mealService" : [ "Meal" ],
          "passengerClass" : "UseVariesByAirline",
          "passengerCode" : "R"
        }, {
          "mealService" : [ "Meal" ],
          "passengerClass" : "BusinessClassDiscounted",
          "passengerCode" : "I"
        }, {
          "mealService" : [ "Meal" ],
          "passengerClass" : "EconomyOrCoachPremium",
          "passengerCode" : "W"
        }, {
          "mealService" : [ "Meal" ],
          "passengerClass" : "ShuttleServiceNoReservationAllowed",
          "passengerCode" : "E"
        }, {
          "mealService" : [ "Meal" ],
          "passengerClass" : "EconomyOrCoachDiscounted",
          "passengerCode" : "T"
        }, {
          "mealService" : [ "Meal" ],
          "passengerClass" : "EconomyOrCoach",
          "passengerCode" : "Y"
        }, {
          "mealService" : [ "Meal" ],
          "passengerClass" : "EconomyOrCoachDiscounted",
          "passengerCode" : "B"
        }, {
          "mealService" : [ "Meal" ],
          "passengerClass" : "EconomyOrCoachDiscounted",
          "passengerCode" : "H"
        }, {
          "mealService" : [ "Meal" ],
          "passengerClass" : "EconomyOrCoachDiscounted",
          "passengerCode" : "K"
        }, {
          "mealService" : [ "Meal" ],
          "passengerClass" : "EconomyOrCoachDiscounted",
          "passengerCode" : "M"
        }, {
          "mealService" : [ "Meal" ],
          "passengerClass" : "EconomyOrCoachDiscounted",
          "passengerCode" : "L"
        }, {
          "mealService" : [ "Meal" ],
          "passengerClass" : "EconomyOrCoachDiscounted",
          "passengerCode" : "V"
        }, {
          "mealService" : [ "Meal" ],
          "passengerClass" : "EconomyOrCoach",
          "passengerCode" : "S"
        }, {
          "mealService" : [ "Meal" ],
          "passengerClass" : "EconomyOrCoachDiscounted",
          "passengerCode" : "N"
        }, {
          "mealService" : [ "Meal" ],
          "passengerClass" : "EconomyOrCoachDiscounted",
          "passengerCode" : "Q"
        }, {
          "mealService" : [ "Meal" ],
          "passengerClass" : "UseVariesByAirline",
          "passengerCode" : "O"
        }, {
          "mealService" : [ "Meal" ],
          "passengerClass" : "ConditionalReservation",
          "passengerCode" : "G"
        } ]
      },
      "onwardFlight" : { },
      "operatingAirline" : "OPERATING_FLIGHT",
      "departureDayDifference" : 0,
      "arrivalDayDifference" : 1,
      "recordSerialNumber" : "394059",
      "marketingCarriers" : [ {
        "airlineDesignator" : "AA",
        "flightNumber" : "6857",
        "flightOperator" : false
      }, {
        "airlineDesignator" : "IB",
        "flightNumber" : "3502",
        "flightOperator" : false
      } ],
      "inFlightServiceInformation" : [ {
        "service" : "Non-smoking"
      } ],
      "electronicTicketingCandidate" : "Y",
      "operatingAirlineDisclosureCode" : "X",
      "flightRouteDetails" : [ {
        "departureAirport" : "LHR",
        "arrivalAirport" : "SIN",
        "legSequenceNumber" : 1
      }, {
        "departureAirport" : "SIN",
        "arrivalAirport" : "SYD",
        "legSequenceNumber" : 2
      } ]
    }, {
      "flightDesignator" : {
        "airlineDesignator" : "BA",
        "flightNumber" : "15",
        "flightOperator" : true
      },
      "itineraryVariationIdentifier" : 1,
      "legSequenceNumber" : 2,
      "serviceType" : "J",
      "operationBegin" : "26NOV2024",
      "operationEnd" : "29MAR2025",
      "daysOfOperation" : [ "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday", "Sunday" ],
      "departureStation" : {
        "type" : "LARGE_AIRPORT",
        "elevation" : 22,
        "continent" : "AS",
        "countryCode" : "SG",
        "region" : "SG-04",
        "name" : "Singapore Changi Airport",
        "iataCode" : "SIN",
        "icaoCode" : "WSSS",
        "city" : "Singapore",
        "lat" : 1.35019,
        "lng" : 103.994003,
        "timezone" : "Asia/Singapore"
      },
      "passengerSTD" : "2005",
      "aircraftSTD" : "2005",
      "utcOffsetDepStation" : "+0800",
      "passengerDepartureTerminal" : "1",
      "arrivalStation" : {
        "type" : "LARGE_AIRPORT",
        "elevation" : 21,
        "continent" : "OC",
        "countryCode" : "AU",
        "region" : "AU-NSW",
        "name" : "Sydney Kingsford Smith International Airport",
        "iataCode" : "SYD",
        "icaoCode" : "YSSY",
        "city" : "Sydney",
        "lat" : -33.94609832763672,
        "lng" : 151.177001953125,
        "timezone" : "Australia/Sydney"
      },
      "aircraftSTA" : "0655",
      "passengerSTA" : "0655",
      "utcOffsetArrStation" : "+1100",
      "passengerArrivalTerminal" : "1",
      "aircraftType" : "77W",
      "prbd" : "FAJCDRIWETYBHKMLVSNQOG",
      "mealService" : {
        "mealServicePerClass" : [ {
          "mealService" : [ "Meal" ],
          "passengerClass" : "FirstClass",
          "passengerCode" : "F"
        }, {
          "mealService" : [ "Meal" ],
          "passengerClass" : "FirstClassDiscounted",
          "passengerCode" : "A"
        }, {
          "mealService" : [ "Meal" ],
          "passengerClass" : "BusinessClassPremium",
          "passengerCode" : "J"
        }, {
          "mealService" : [ "Meal" ],
          "passengerClass" : "BusinessClass",
          "passengerCode" : "C"
        }, {
          "mealService" : [ "Meal" ],
          "passengerClass" : "BusinessClassDiscounted",
          "passengerCode" : "D"
        }, {
          "mealService" : [ "Meal" ],
          "passengerClass" : "UseVariesByAirline",
          "passengerCode" : "R"
        }, {
          "mealService" : [ "Meal" ],
          "passengerClass" : "BusinessClassDiscounted",
          "passengerCode" : "I"
        }, {
          "mealService" : [ "Meal" ],
          "passengerClass" : "EconomyOrCoachPremium",
          "passengerCode" : "W"
        }, {
          "mealService" : [ "Meal" ],
          "passengerClass" : "ShuttleServiceNoReservationAllowed",
          "passengerCode" : "E"
        }, {
          "mealService" : [ "Meal" ],
          "passengerClass" : "EconomyOrCoachDiscounted",
          "passengerCode" : "T"
        }, {
          "mealService" : [ "Meal" ],
          "passengerClass" : "EconomyOrCoach",
          "passengerCode" : "Y"
        }, {
          "mealService" : [ "Meal" ],
          "passengerClass" : "EconomyOrCoachDiscounted",
          "passengerCode" : "B"
        }, {
          "mealService" : [ "Meal" ],
          "passengerClass" : "EconomyOrCoachDiscounted",
          "passengerCode" : "H"
        }, {
          "mealService" : [ "Meal" ],
          "passengerClass" : "EconomyOrCoachDiscounted",
          "passengerCode" : "K"
        }, {
          "mealService" : [ "Meal" ],
          "passengerClass" : "EconomyOrCoachDiscounted",
          "passengerCode" : "M"
        }, {
          "mealService" : [ "Meal" ],
          "passengerClass" : "EconomyOrCoachDiscounted",
          "passengerCode" : "L"
        }, {
          "mealService" : [ "Meal" ],
          "passengerClass" : "EconomyOrCoachDiscounted",
          "passengerCode" : "V"
        }, {
          "mealService" : [ "Meal" ],
          "passengerClass" : "EconomyOrCoach",
          "passengerCode" : "S"
        }, {
          "mealService" : [ "Meal" ],
          "passengerClass" : "EconomyOrCoachDiscounted",
          "passengerCode" : "N"
        }, {
          "mealService" : [ "Meal" ],
          "passengerClass" : "EconomyOrCoachDiscounted",
          "passengerCode" : "Q"
        }, {
          "mealService" : [ "Meal" ],
          "passengerClass" : "UseVariesByAirline",
          "passengerCode" : "O"
        }, {
          "mealService" : [ "Meal" ],
          "passengerClass" : "ConditionalReservation",
          "passengerCode" : "G"
        } ]
      },
      "onwardFlight" : { },
      "operatingAirline" : "OPERATING_FLIGHT",
      "departureDayDifference" : 0,
      "arrivalDayDifference" : 1,
      "recordSerialNumber" : "394066",
      "marketingCarriers" : [ {
        "airlineDesignator" : "AY",
        "flightNumber" : "5915",
        "flightOperator" : false
      }, {
        "airlineDesignator" : "IB",
        "flightNumber" : "3502",
        "flightOperator" : false
      } ],
      "inFlightServiceInformation" : [ {
        "service" : "Non-smoking"
      } ],
      "electronicTicketingCandidate" : "Y",
      "operatingAirlineDisclosureCode" : "X",
      "flightRouteDetails" : [ {
        "departureAirport" : "LHR",
        "arrivalAirport" : "SIN",
        "legSequenceNumber" : 1
      }, {
        "departureAirport" : "SIN",
        "arrivalAirport" : "SYD",
        "legSequenceNumber" : 2
      } ]
    } ],
    "flightNumber" : "15",
    "itineraryVariationIdentifier" : 1
  } ],
  "operationDateFrom" : "2024-11-27",
  "operationDateTo" : "2024-11-27"
}

3.1.7 Schedule By Airline and Flight Number, Departure and OperationDate

Path parameters

Table 1. /{version}/airline/{airline}/flightNumber/{flightNumber}/departure/{departure}
Parameter	Description
`version`	The version of this API e.g. v1
`airline`	Valid IATA/ICAO Airline Code
`flightNumber`	Flight number
`departure`	Valid IATA/ICAO departure 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
`operationDate`	Date of Operation (Valid format is 'yyyy-MM-dd'). If not defined, current UTC date will be assigned
`groupMarketingCarriers`	Group associated marketing and operating carrier flights into a single record. Default false.

Response fields

Path	Type	Description
`airline`	`String`	2-character IATA or 3-character ICAO airline code
`arrival`	`String`	3-character IATA or 4-character ICAO arrival airport code
`departure`	`String`	3-character IATA or 4-character ICAO departure airport code
`flightNumber`	`String`	Flight number
`fullSchedules[].airline`	`String`	2-character IATA or 3-character ICAO airline code
`fullSchedules[].arrival`	`String`	3-character IATA or 4-character ICAO arrival airport code
`fullSchedules[].departure`	`String`	3-character IATA or 4-character ICAO departure airport code
`fullSchedules[].flightLegs[].aircraftOwner`	`String`	Aircraft owner
`fullSchedules[].flightLegs[].aircraftSTA`	`String`	Aircraft schedule time of arrival
`fullSchedules[].flightLegs[].aircraftSTD`	`String`	The scheduled departure time of an aircraft from the terminal or departure gate/position at an airport
`fullSchedules[].flightLegs[].aircraftType`	`String`	Aircraft type
`fullSchedules[].flightLegs[].aircraftVersion`	`String`	Aircraft version
`fullSchedules[].flightLegs[].arrivalDayDifference`	`Number`	Arrival day difference
`fullSchedules[].flightLegs[].arrivalStation.city`	`String`	Arrival airport city
`fullSchedules[].flightLegs[].arrivalStation.continent`	`String`	Continent where airport is located
`fullSchedules[].flightLegs[].arrivalStation.country`	`String`	Arrival airport country
`fullSchedules[].flightLegs[].arrivalStation.countryCode`	`String`	Arrival airport country code
`fullSchedules[].flightLegs[].arrivalStation.elevation`	`Number`	Airport Elevation
`fullSchedules[].flightLegs[].arrivalStation.iataCode`	`String`	Arrival airport IATA code e.g JFK
`fullSchedules[].flightLegs[].arrivalStation.icaoCode`	`String`	Arrival airport ICAO code e.g KJFK
`fullSchedules[].flightLegs[].arrivalStation.ident`	`String`	Arrival airport ident
`fullSchedules[].flightLegs[].arrivalStation.lat`	`Number`	Arrival airport latitude position
`fullSchedules[].flightLegs[].arrivalStation.lng`	`Number`	Arrival airport longitude position
`fullSchedules[].flightLegs[].arrivalStation.localCode`	`String`	Arrival airport local code
`fullSchedules[].flightLegs[].arrivalStation.name`	`String`	Arrival airport full name
`fullSchedules[].flightLegs[].arrivalStation.region`	`String`	Arrival airport region
`fullSchedules[].flightLegs[].arrivalStation.timezone`	`String`	Arrival airport timezone
`fullSchedules[].flightLegs[].arrivalStation.type`	`String`	Arrival airport type e.g. LARGE_AIRPORT
`fullSchedules[].flightLegs[].cabinCrewEmployer`	`String`	Cabin crew employer
`fullSchedules[].flightLegs[].cockpitCrewEmployer`	`String`	Cockpit crew employer
`fullSchedules[].flightLegs[].daysOfOperation`	`Array`	Days of operation
`fullSchedules[].flightLegs[].departureDayDifference`	`Number`	Departure day difference
`fullSchedules[].flightLegs[].departureStation.city`	`String`	Departure airport city
`fullSchedules[].flightLegs[].departureStation.continent`	`String`	Departure airport continent
`fullSchedules[].flightLegs[].departureStation.country`	`String`	Departure airport country
`fullSchedules[].flightLegs[].departureStation.countryCode`	`String`	Departure airport country code
`fullSchedules[].flightLegs[].departureStation.elevation`	`Number`	Airport altitude
`fullSchedules[].flightLegs[].departureStation.iataCode`	`String`	Departure airport IATA code e.g JFK
`fullSchedules[].flightLegs[].departureStation.icaoCode`	`String`	Departure airport ICAO code e.g KJFK
`fullSchedules[].flightLegs[].departureStation.ident`	`String`	Departure airport identification
`fullSchedules[].flightLegs[].departureStation.lat`	`Number`	Departure airport latitude position
`fullSchedules[].flightLegs[].departureStation.lng`	`Number`	Departure airport longitude position
`fullSchedules[].flightLegs[].departureStation.localCode`	`String`	Departure airport local code
`fullSchedules[].flightLegs[].departureStation.name`	`String`	Departure airport full name
`fullSchedules[].flightLegs[].departureStation.region`	`String`	Departure airport region
`fullSchedules[].flightLegs[].departureStation.timezone`	`String`	Departure airport timezone
`fullSchedules[].flightLegs[].departureStation.type`	`String`	Departure airport type e.g. LARGE_AIRPORT
`fullSchedules[].flightLegs[].electronicTicketingCandidate`	`String`	Electronic ticketing candidate
`fullSchedules[].flightLegs[].flightDesignator.airlineDesignator`	`String`	2-character IATA or 3-character ICAO airline code
`fullSchedules[].flightLegs[].flightDesignator.flightNumber`	`String`	Flight number
`fullSchedules[].flightLegs[].flightDesignator.flightOperator`	`Boolean`	A boolean
`fullSchedules[].flightLegs[].flightRouteDetails[].arrivalAirport`	`String`	Arrival airport on this route
`fullSchedules[].flightLegs[].flightRouteDetails[].departureAirport`	`String`	Departure airport on this route
`fullSchedules[].flightLegs[].flightRouteDetails[].legSequenceNumber`	`Number`	Indicates the position where this leg operates on a route, corresponds with legSequenceNumber on payload
`fullSchedules[].flightLegs[].flightTransitLayover`	`String`	Flight transit layover
`fullSchedules[].flightLegs[].frequencyRate`	`String`	Flight frequency rate
`fullSchedules[].flightLegs[].inFlightServiceInformation[].service`	`String`	Available in-flight service
`fullSchedules[].flightLegs[].itineraryVariationIdentifier`	`Number`	A number used to differentiate between itineraries with the same Flight Designator (excluding Operational Suffixes, if any)
`fullSchedules[].flightLegs[].itineraryVariationIdentifierOverflow`	`String`	Itinerary variation identifier
`fullSchedules[].flightLegs[].jointOperationAirline`	`String`	Joint operation airline
`fullSchedules[].flightLegs[].legSequenceNumber`	`Number`	Sequence number
`fullSchedules[].flightLegs[].marketingCarriers[].airlineDesignator`	`String`	Marketing airline code
`fullSchedules[].flightLegs[].marketingCarriers[].flightNumber`	`String`	Marketing airline flight number
`fullSchedules[].flightLegs[].marketingCarriers[].flightOperator`	`Boolean`	Indicates if the airline is the flight operator
`fullSchedules[].flightLegs[].mealService.mealServicePerClass[].mealService`	`Array`	Type of meal service e.g. Breakfast
`fullSchedules[].flightLegs[].mealService.mealServicePerClass[].passengerClass`	`String`	Passenger service class name e.g. BusinessClassPremium
`fullSchedules[].flightLegs[].mealService.mealServicePerClass[].passengerCode`	`String`	Passenger service class code e.g. A
`fullSchedules[].flightLegs[].minimumConnectingTime`	`String`	Minimum connecting time
`fullSchedules[].flightLegs[].onTimePerformanceIndicator`	`String`	On time performance indicator
`fullSchedules[].flightLegs[].onwardFlight`	`Object`	Onward flight details
`fullSchedules[].flightLegs[].onwardFlight.aircraftRotationLayover`	`String`	Aircraft rotation layover
`fullSchedules[].flightLegs[].onwardFlight.airlineDesignator`	`String`	Airline code of onward flight
`fullSchedules[].flightLegs[].onwardFlight.flightNumber`	`String`	Flight number of onward flight
`fullSchedules[].flightLegs[].onwardFlight.operationSuffix`	`String`	Flight suffix of onward flight e.g. 4A, 123B
`fullSchedules[].flightLegs[].operatingAirline`	`String`	Operating airline
`fullSchedules[].flightLegs[].operatingAirlineDisclosureCode`	`String`	Operating airline disclosure code
`fullSchedules[].flightLegs[].operationBegin`	`String`	Operation begin date
`fullSchedules[].flightLegs[].operationEnd`	`String`	Operation end date
`fullSchedules[].flightLegs[].passengerArrivalTerminal`	`String`	Arrival terminal
`fullSchedules[].flightLegs[].passengerDepartureTerminal`	`String`	Departure terminal
`fullSchedules[].flightLegs[].passengerSTA`	`String`	Passenger schedule time of arrival
`fullSchedules[].flightLegs[].passengerSTD`	`String`	The scheduled time of departure of the passenger at the terminal or departure gate at an airport”.
`fullSchedules[].flightLegs[].prbd`	`String`	Passenger Reservations Booking Designator
`fullSchedules[].flightLegs[].prbm`	`String`	Passenger Reservations Booking Modifier
`fullSchedules[].flightLegs[].recordSerialNumber`	`String`	Record serial number
`fullSchedules[].flightLegs[].secureFlightIndicator`	`String`	Secure flight indicator
`fullSchedules[].flightLegs[].serviceType`	`String`	Service type
`fullSchedules[].flightLegs[].trafficRestrictionCode`	`String`	Traffic restriction code
`fullSchedules[].flightLegs[].trafficRestrictionCodeLegOverflowIndication`	`String`	Traffic Restriction Code for flight leg
`fullSchedules[].flightLegs[].utcOffsetArrStation`	`String`	UTC offset at arrival airport
`fullSchedules[].flightLegs[].utcOffsetDepStation`	`String`	UTC offset at departure airport
`fullSchedules[].flightNumber`	`String`	Flight number
`fullSchedules[].itineraryVariationIdentifier`	`Number`	A number used to differentiate between itineraries with the same Flight Designator (excluding Operational Suffixes, if any)
`operationDate`	`String`	Query period.
`operationDateFrom`	`String`	Start date of query period.
`operationDateTo`	`String`	End date of query period.

Curl request

$ curl 'https://sitaopen.api.aero/schedule/v1/airline/BA/flightNumber/15/departure/LHR?operationDate=2024-11-27&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: 11764

{
  "airline" : "BA",
  "departure" : "LHR",
  "flightNumber" : "15",
  "fullSchedules" : [ {
    "arrival" : "SYD",
    "departure" : "LHR",
    "flightLegs" : [ {
      "flightDesignator" : {
        "airlineDesignator" : "BA",
        "flightNumber" : "15",
        "flightOperator" : true
      },
      "itineraryVariationIdentifier" : 1,
      "legSequenceNumber" : 1,
      "serviceType" : "J",
      "operationBegin" : "25NOV2024",
      "operationEnd" : "28MAR2025",
      "daysOfOperation" : [ "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday", "Sunday" ],
      "departureStation" : {
        "type" : "LARGE_AIRPORT",
        "elevation" : 83,
        "continent" : "EU",
        "countryCode" : "GB",
        "region" : "GB-ENG",
        "name" : "London Heathrow Airport",
        "iataCode" : "LHR",
        "icaoCode" : "EGLL",
        "city" : "London",
        "lat" : 51.4706,
        "lng" : -0.461941,
        "timezone" : "Europe/London"
      },
      "passengerSTD" : "2110",
      "aircraftSTD" : "2110",
      "utcOffsetDepStation" : "+0000",
      "passengerDepartureTerminal" : "5",
      "arrivalStation" : {
        "type" : "LARGE_AIRPORT",
        "elevation" : 22,
        "continent" : "AS",
        "countryCode" : "SG",
        "region" : "SG-04",
        "name" : "Singapore Changi Airport",
        "iataCode" : "SIN",
        "icaoCode" : "WSSS",
        "city" : "Singapore",
        "lat" : 1.35019,
        "lng" : 103.994003,
        "timezone" : "Asia/Singapore"
      },
      "aircraftSTA" : "1825",
      "passengerSTA" : "1825",
      "utcOffsetArrStation" : "+0800",
      "passengerArrivalTerminal" : "1",
      "aircraftType" : "77W",
      "prbd" : "FAJCDRIWETYBHKMLVSNQOG",
      "mealService" : {
        "mealServicePerClass" : [ {
          "mealService" : [ "Meal" ],
          "passengerClass" : "FirstClass",
          "passengerCode" : "F"
        }, {
          "mealService" : [ "Meal" ],
          "passengerClass" : "FirstClassDiscounted",
          "passengerCode" : "A"
        }, {
          "mealService" : [ "Meal" ],
          "passengerClass" : "BusinessClassPremium",
          "passengerCode" : "J"
        }, {
          "mealService" : [ "Meal" ],
          "passengerClass" : "BusinessClass",
          "passengerCode" : "C"
        }, {
          "mealService" : [ "Meal" ],
          "passengerClass" : "BusinessClassDiscounted",
          "passengerCode" : "D"
        }, {
          "mealService" : [ "Meal" ],
          "passengerClass" : "UseVariesByAirline",
          "passengerCode" : "R"
        }, {
          "mealService" : [ "Meal" ],
          "passengerClass" : "BusinessClassDiscounted",
          "passengerCode" : "I"
        }, {
          "mealService" : [ "Meal" ],
          "passengerClass" : "EconomyOrCoachPremium",
          "passengerCode" : "W"
        }, {
          "mealService" : [ "Meal" ],
          "passengerClass" : "ShuttleServiceNoReservationAllowed",
          "passengerCode" : "E"
        }, {
          "mealService" : [ "Meal" ],
          "passengerClass" : "EconomyOrCoachDiscounted",
          "passengerCode" : "T"
        }, {
          "mealService" : [ "Meal" ],
          "passengerClass" : "EconomyOrCoach",
          "passengerCode" : "Y"
        }, {
          "mealService" : [ "Meal" ],
          "passengerClass" : "EconomyOrCoachDiscounted",
          "passengerCode" : "B"
        }, {
          "mealService" : [ "Meal" ],
          "passengerClass" : "EconomyOrCoachDiscounted",
          "passengerCode" : "H"
        }, {
          "mealService" : [ "Meal" ],
          "passengerClass" : "EconomyOrCoachDiscounted",
          "passengerCode" : "K"
        }, {
          "mealService" : [ "Meal" ],
          "passengerClass" : "EconomyOrCoachDiscounted",
          "passengerCode" : "M"
        }, {
          "mealService" : [ "Meal" ],
          "passengerClass" : "EconomyOrCoachDiscounted",
          "passengerCode" : "L"
        }, {
          "mealService" : [ "Meal" ],
          "passengerClass" : "EconomyOrCoachDiscounted",
          "passengerCode" : "V"
        }, {
          "mealService" : [ "Meal" ],
          "passengerClass" : "EconomyOrCoach",
          "passengerCode" : "S"
        }, {
          "mealService" : [ "Meal" ],
          "passengerClass" : "EconomyOrCoachDiscounted",
          "passengerCode" : "N"
        }, {
          "mealService" : [ "Meal" ],
          "passengerClass" : "EconomyOrCoachDiscounted",
          "passengerCode" : "Q"
        }, {
          "mealService" : [ "Meal" ],
          "passengerClass" : "UseVariesByAirline",
          "passengerCode" : "O"
        }, {
          "mealService" : [ "Meal" ],
          "passengerClass" : "ConditionalReservation",
          "passengerCode" : "G"
        } ]
      },
      "onwardFlight" : { },
      "operatingAirline" : "OPERATING_FLIGHT",
      "departureDayDifference" : 0,
      "arrivalDayDifference" : 1,
      "recordSerialNumber" : "394059",
      "marketingCarriers" : [ {
        "airlineDesignator" : "AA",
        "flightNumber" : "6857",
        "flightOperator" : false
      }, {
        "airlineDesignator" : "IB",
        "flightNumber" : "3502",
        "flightOperator" : false
      } ],
      "inFlightServiceInformation" : [ {
        "service" : "Non-smoking"
      } ],
      "electronicTicketingCandidate" : "Y",
      "operatingAirlineDisclosureCode" : "X",
      "flightRouteDetails" : [ {
        "departureAirport" : "LHR",
        "arrivalAirport" : "SIN",
        "legSequenceNumber" : 1
      }, {
        "departureAirport" : "SIN",
        "arrivalAirport" : "SYD",
        "legSequenceNumber" : 2
      } ]
    }, {
      "flightDesignator" : {
        "airlineDesignator" : "BA",
        "flightNumber" : "15",
        "flightOperator" : true
      },
      "itineraryVariationIdentifier" : 1,
      "legSequenceNumber" : 2,
      "serviceType" : "J",
      "operationBegin" : "26NOV2024",
      "operationEnd" : "29MAR2025",
      "daysOfOperation" : [ "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday", "Sunday" ],
      "departureStation" : {
        "type" : "LARGE_AIRPORT",
        "elevation" : 22,
        "continent" : "AS",
        "countryCode" : "SG",
        "region" : "SG-04",
        "name" : "Singapore Changi Airport",
        "iataCode" : "SIN",
        "icaoCode" : "WSSS",
        "city" : "Singapore",
        "lat" : 1.35019,
        "lng" : 103.994003,
        "timezone" : "Asia/Singapore"
      },
      "passengerSTD" : "2005",
      "aircraftSTD" : "2005",
      "utcOffsetDepStation" : "+0800",
      "passengerDepartureTerminal" : "1",
      "arrivalStation" : {
        "type" : "LARGE_AIRPORT",
        "elevation" : 21,
        "continent" : "OC",
        "countryCode" : "AU",
        "region" : "AU-NSW",
        "name" : "Sydney Kingsford Smith International Airport",
        "iataCode" : "SYD",
        "icaoCode" : "YSSY",
        "city" : "Sydney",
        "lat" : -33.94609832763672,
        "lng" : 151.177001953125,
        "timezone" : "Australia/Sydney"
      },
      "aircraftSTA" : "0655",
      "passengerSTA" : "0655",
      "utcOffsetArrStation" : "+1100",
      "passengerArrivalTerminal" : "1",
      "aircraftType" : "77W",
      "prbd" : "FAJCDRIWETYBHKMLVSNQOG",
      "mealService" : {
        "mealServicePerClass" : [ {
          "mealService" : [ "Meal" ],
          "passengerClass" : "FirstClass",
          "passengerCode" : "F"
        }, {
          "mealService" : [ "Meal" ],
          "passengerClass" : "FirstClassDiscounted",
          "passengerCode" : "A"
        }, {
          "mealService" : [ "Meal" ],
          "passengerClass" : "BusinessClassPremium",
          "passengerCode" : "J"
        }, {
          "mealService" : [ "Meal" ],
          "passengerClass" : "BusinessClass",
          "passengerCode" : "C"
        }, {
          "mealService" : [ "Meal" ],
          "passengerClass" : "BusinessClassDiscounted",
          "passengerCode" : "D"
        }, {
          "mealService" : [ "Meal" ],
          "passengerClass" : "UseVariesByAirline",
          "passengerCode" : "R"
        }, {
          "mealService" : [ "Meal" ],
          "passengerClass" : "BusinessClassDiscounted",
          "passengerCode" : "I"
        }, {
          "mealService" : [ "Meal" ],
          "passengerClass" : "EconomyOrCoachPremium",
          "passengerCode" : "W"
        }, {
          "mealService" : [ "Meal" ],
          "passengerClass" : "ShuttleServiceNoReservationAllowed",
          "passengerCode" : "E"
        }, {
          "mealService" : [ "Meal" ],
          "passengerClass" : "EconomyOrCoachDiscounted",
          "passengerCode" : "T"
        }, {
          "mealService" : [ "Meal" ],
          "passengerClass" : "EconomyOrCoach",
          "passengerCode" : "Y"
        }, {
          "mealService" : [ "Meal" ],
          "passengerClass" : "EconomyOrCoachDiscounted",
          "passengerCode" : "B"
        }, {
          "mealService" : [ "Meal" ],
          "passengerClass" : "EconomyOrCoachDiscounted",
          "passengerCode" : "H"
        }, {
          "mealService" : [ "Meal" ],
          "passengerClass" : "EconomyOrCoachDiscounted",
          "passengerCode" : "K"
        }, {
          "mealService" : [ "Meal" ],
          "passengerClass" : "EconomyOrCoachDiscounted",
          "passengerCode" : "M"
        }, {
          "mealService" : [ "Meal" ],
          "passengerClass" : "EconomyOrCoachDiscounted",
          "passengerCode" : "L"
        }, {
          "mealService" : [ "Meal" ],
          "passengerClass" : "EconomyOrCoachDiscounted",
          "passengerCode" : "V"
        }, {
          "mealService" : [ "Meal" ],
          "passengerClass" : "EconomyOrCoach",
          "passengerCode" : "S"
        }, {
          "mealService" : [ "Meal" ],
          "passengerClass" : "EconomyOrCoachDiscounted",
          "passengerCode" : "N"
        }, {
          "mealService" : [ "Meal" ],
          "passengerClass" : "EconomyOrCoachDiscounted",
          "passengerCode" : "Q"
        }, {
          "mealService" : [ "Meal" ],
          "passengerClass" : "UseVariesByAirline",
          "passengerCode" : "O"
        }, {
          "mealService" : [ "Meal" ],
          "passengerClass" : "ConditionalReservation",
          "passengerCode" : "G"
        } ]
      },
      "onwardFlight" : { },
      "operatingAirline" : "OPERATING_FLIGHT",
      "departureDayDifference" : 0,
      "arrivalDayDifference" : 1,
      "recordSerialNumber" : "394066",
      "marketingCarriers" : [ {
        "airlineDesignator" : "AY",
        "flightNumber" : "5915",
        "flightOperator" : false
      }, {
        "airlineDesignator" : "IB",
        "flightNumber" : "3502",
        "flightOperator" : false
      } ],
      "inFlightServiceInformation" : [ {
        "service" : "Non-smoking"
      } ],
      "electronicTicketingCandidate" : "Y",
      "operatingAirlineDisclosureCode" : "X",
      "flightRouteDetails" : [ {
        "departureAirport" : "LHR",
        "arrivalAirport" : "SIN",
        "legSequenceNumber" : 1
      }, {
        "departureAirport" : "SIN",
        "arrivalAirport" : "SYD",
        "legSequenceNumber" : 2
      } ]
    } ],
    "flightNumber" : "15",
    "itineraryVariationIdentifier" : 1
  } ],
  "operationDate" : "2024-11-27"
}

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" : [ {
      "code" : 2028,
      "description" : "Invalid page size.",
      "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

SITA Flight Schedule API

Registration and API Signup

3 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