Overview
Flight Information Display Systems are used by airports to display real-time flight information for the ease of passengers. Flight Information Display Systems are mostly deployed at airport lounges, terminals, food courts, hotels, duty free area and wherever passengers can be present on the airport premises.
SITA Flight Information Display API, allows the users to let go of the pain and effort of integrating with various data sources to display relevant information on Flight Information Display Systems. SITA Flight Information Display API provides a one-stop solution to empower Flight Information Display Systems with real-time data being flexible enough to customize it according to end-user.
See our 'Try it Now' page for more details.
Airline Icons
We also make icons available to enable you to create a graphical display of the Airline Icons. See documentation for a full list.
SITA Flight Information Display API Service
1 Revision History
| Date | Version | Description |
|---|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
2 Technical Documentation
SITA Flight Information Display API is a REST based service which provides information about flight departures and arrivals around the world.
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. To obtain an OAuth token a request must be sent to the https://sitaopen.api.aero/fids/oauth/token endpoint using the OAuth2 Client Credential flow, using your API key as the client_id, and your consumer secret as the client_secret.
Once an access token has been obtained, it can be placed in the Authorization HTTP header as a bearer token, for example:
Authorization: Bearer eyJ92dNw9dka...
2.2 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.3 Rate Limiting
All incoming requests are subject to a rate limiting restriction. The following headers are included in HTTP responses:
| Header | Description |
|---|---|
|
|
The total number of requests allowed in the current time window |
|
|
The number of requests left for the current time window |
|
|
The policy describing how many request per time window are allowed |
|
|
The number of seconds remaining in the current time window. Header not displayed after rate limit has been exceeded |
|
|
The epoch timestamp at which the current rate limit window resets. Header only displayed after rate limit has been exceeded |
2.4 Error Response
Response fields
| Path | Type | Description |
|---|---|---|
|
|
|
Object that holds the error information |
|
|
|
Array of errors |
|
|
|
Flight Information Display API Internal Error Code |
|
|
|
Error Description |
|
|
|
Indicates the invalid query parameter |
HTTP response
HTTP/1.1 400 Bad Request
Content-Type: application/json
Content-Length: 159
{
"errors" : {
"error" : [ {
"description" : "Error Description",
"code" : 9999,
"invalidParam" : "parameterName"
} ]
}
}
3 SITA Flight Information Display API Service
This section describes each SITA Flight Information Display API service. Detailed API structure, example requests and responses, JSON schema for request (where appropriate) and responses, and error response codes and formats are included.
3.1 V1
3.4.3 Get Flights by Airport
Path parameters
| Parameter | Description |
|---|---|
|
|
3-character airport IATA code or 4-character airport ICAO code |
|
|
1-character direction indicator (A/D) |
Request parameters
Snippet request-parameters not found for operation::V1DocumentationTest/getFlightsByAirport/1
Request headers
| Name | Description |
|---|---|
|
|
Content type of this request. |
|
|
Authorization header that contains the access token. |
Response fields
| Path | Type | Description |
|---|---|---|
|
|
|
Data |
|
|
|
Actual Date |
|
|
|
Actual Time |
|
|
|
Airline Code |
|
|
|
airline icons from both operating and maketing carriers |
|
|
|
Airline Name |
|
|
|
Airport Code |
|
|
|
Airport Name |
|
|
|
Baggage |
|
|
|
Code Share Indicator |
|
|
|
Code Shares As Codes |
|
|
|
Code Shares As Names |
|
|
|
Delayed |
|
|
|
Destination Airport Code |
|
|
|
Destination Airport Name |
|
|
|
Destination Country Code |
|
|
|
Estimated Date |
|
|
|
Estimated Time |
|
|
|
Flight |
|
|
|
Flight Number |
|
|
|
Gate |
|
|
|
Operated Flight Number |
|
|
|
Operating Airline Code |
|
|
|
Operating Airline Name |
|
|
|
Origin Airport Code |
|
|
|
Origin Airport Name |
|
|
|
Origin Country Code |
|
|
|
Scheduled Date |
|
|
|
Scheduled Time |
|
|
|
Status |
|
|
|
Status Code |
|
|
|
Temperature C |
|
|
|
Temperature F |
|
|
|
Terminal |
|
|
|
Weather |
Curl request
$ curl 'https://sitaopen.api.aero/fids/v1/AMS/A' -i -X GET \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer eyJkb2N1bWVudGF0aW9uIiwidG9rZW4ifQ...'
HTTP response
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 10262
{
"flightRecords" : [ {
"status" : "Arrived",
"statusCode" : "AR",
"airlineName" : "KLM Royal Dutch Airlines",
"airlineCode" : "KL",
"flightNumber" : "1386",
"codeShare" : false,
"operatedFlightNumber" : "1386",
"operatingAirlineName" : "KLM Royal Dutch Airlines",
"operatingAirlineCode" : "KL",
"originAirportName" : "Boryspil International Airport",
"originAirportCode" : "KBP",
"originCountryCode" : "UA",
"destinationAirportName" : "Amsterdam Airport Schiphol",
"destinationAirportCode" : "AMS",
"destinationCountryCode" : "NL",
"flight" : "KL 1386",
"delayed" : false,
"airportCode" : "AMS",
"airportName" : "Amsterdam Airport Schiphol",
"gate" : "A9",
"terminal" : "3",
"scheduledTime" : "15:00:00",
"scheduledDate" : "2020-08-20",
"actualTime" : "14:44:00",
"actualDate" : "2020-08-20",
"codeSharesAsNames" : [ "Ukraine International Airlines 9386", "Delta Air Lines 9473" ],
"codeSharesAsCodes" : [ "PS 9386", "DL 9473" ],
"weather" : "Mostly sunny",
"temperatureC" : 26.0,
"temperatureF" : 78.8
}, {
"status" : "Arrived",
"statusCode" : "AR",
"airlineName" : "Delta Air Lines",
"airlineCode" : "DL",
"flightNumber" : "9598",
"codeShare" : true,
"operatedFlightNumber" : "1146",
"operatingAirlineName" : "KLM Royal Dutch Airlines",
"operatingAirlineCode" : "KL",
"originAirportName" : "Oslo Gardermoen Airport",
"originAirportCode" : "OSL",
"originCountryCode" : "NO",
"destinationAirportName" : "Amsterdam Airport Schiphol",
"destinationAirportCode" : "AMS",
"destinationCountryCode" : "NL",
"flight" : "DL 9598",
"delayed" : false,
"airportCode" : "AMS",
"airportName" : "Amsterdam Airport Schiphol",
"gate" : "A4",
"terminal" : "2",
"scheduledTime" : "15:00:00",
"scheduledDate" : "2020-08-20",
"actualTime" : "15:03:00",
"actualDate" : "2020-08-20",
"weather" : "Mostly sunny",
"temperatureC" : 26.0,
"temperatureF" : 78.8
}, {
"status" : "Arrived",
"statusCode" : "AR",
"airlineName" : "KLM Royal Dutch Airlines",
"airlineCode" : "KL",
"flightNumber" : "1386",
"codeShare" : false,
"operatedFlightNumber" : "1386",
"operatingAirlineName" : "KLM Royal Dutch Airlines",
"operatingAirlineCode" : "KL",
"originAirportName" : "Boryspil International Airport",
"originAirportCode" : "KBP",
"originCountryCode" : "UA",
"destinationAirportName" : "Amsterdam Airport Schiphol",
"destinationAirportCode" : "AMS",
"destinationCountryCode" : "NL",
"flight" : "KL 1386",
"delayed" : false,
"airportCode" : "AMS",
"airportName" : "Amsterdam Airport Schiphol",
"gate" : "A9",
"terminal" : "3",
"scheduledTime" : "15:00:00",
"scheduledDate" : "2020-08-20",
"actualTime" : "14:44:00",
"actualDate" : "2020-08-20",
"codeSharesAsNames" : [ "Ukraine International Airlines 9386", "Delta Air Lines 9473" ],
"codeSharesAsCodes" : [ "PS 9386", "DL 9473" ],
"weather" : "Mostly sunny",
"temperatureC" : 26.0,
"temperatureF" : 78.8
}, {
"status" : "Arrived",
"statusCode" : "AR",
"airlineName" : "Aeroflot Russian Airlines",
"airlineCode" : "SU",
"flightNumber" : "3410",
"codeShare" : true,
"operatedFlightNumber" : "1394",
"operatingAirlineName" : "KLM Royal Dutch Airlines",
"operatingAirlineCode" : "KL",
"originAirportName" : "Pulkovo Airport",
"originAirportCode" : "LED",
"originCountryCode" : "RU",
"destinationAirportName" : "Amsterdam Airport Schiphol",
"destinationAirportCode" : "AMS",
"destinationCountryCode" : "NL",
"flight" : "SU 3410",
"delayed" : false,
"airportCode" : "AMS",
"airportName" : "Amsterdam Airport Schiphol",
"gate" : "A9",
"terminal" : "3",
"scheduledTime" : "15:00:00",
"scheduledDate" : "2020-08-20",
"actualTime" : "14:47:00",
"actualDate" : "2020-08-20",
"weather" : "Mostly sunny",
"temperatureC" : 26.0,
"temperatureF" : 78.8
}, {
"status" : "Arrived",
"statusCode" : "AR",
"airlineName" : "Aeroflot Russian Airlines",
"airlineCode" : "SU",
"flightNumber" : "3410",
"codeShare" : true,
"operatedFlightNumber" : "1394",
"operatingAirlineName" : "KLM Royal Dutch Airlines",
"operatingAirlineCode" : "KL",
"originAirportName" : "Pulkovo Airport",
"originAirportCode" : "LED",
"originCountryCode" : "RU",
"destinationAirportName" : "Amsterdam Airport Schiphol",
"destinationAirportCode" : "AMS",
"destinationCountryCode" : "NL",
"flight" : "SU 3410",
"delayed" : false,
"airportCode" : "AMS",
"airportName" : "Amsterdam Airport Schiphol",
"gate" : "A9",
"terminal" : "3",
"scheduledTime" : "15:00:00",
"scheduledDate" : "2020-08-20",
"actualTime" : "14:47:00",
"actualDate" : "2020-08-20",
"weather" : "Mostly sunny",
"temperatureC" : 26.0,
"temperatureF" : 78.8
}, {
"status" : "Arrived",
"statusCode" : "AR",
"airlineName" : "Delta Air Lines",
"airlineCode" : "DL",
"flightNumber" : "9598",
"codeShare" : true,
"operatedFlightNumber" : "1146",
"operatingAirlineName" : "KLM Royal Dutch Airlines",
"operatingAirlineCode" : "KL",
"originAirportName" : "Oslo Gardermoen Airport",
"originAirportCode" : "OSL",
"originCountryCode" : "NO",
"destinationAirportName" : "Amsterdam Airport Schiphol",
"destinationAirportCode" : "AMS",
"destinationCountryCode" : "NL",
"flight" : "DL 9598",
"delayed" : false,
"airportCode" : "AMS",
"airportName" : "Amsterdam Airport Schiphol",
"gate" : "A4",
"terminal" : "2",
"scheduledTime" : "15:00:00",
"scheduledDate" : "2020-08-20",
"actualTime" : "15:03:00",
"actualDate" : "2020-08-20",
"weather" : "Mostly sunny",
"temperatureC" : 26.0,
"temperatureF" : 78.8
}, {
"status" : "Arrived",
"statusCode" : "AR",
"airlineName" : "TAP Portugal",
"airlineCode" : "TP",
"flightNumber" : "678",
"codeShare" : false,
"operatedFlightNumber" : "678",
"operatingAirlineName" : "TAP Portugal",
"operatingAirlineCode" : "TP",
"originAirportName" : "Francisco de Sá Carneiro Airport",
"originAirportCode" : "OPO",
"originCountryCode" : "PT",
"destinationAirportName" : "Amsterdam Airport Schiphol",
"destinationAirportCode" : "AMS",
"destinationCountryCode" : "NL",
"flight" : "TP 678",
"delayed" : false,
"airportCode" : "AMS",
"airportName" : "Amsterdam Airport Schiphol",
"gate" : "C14",
"terminal" : "1",
"scheduledTime" : "15:00:00",
"scheduledDate" : "2020-08-20",
"actualTime" : "14:53:00",
"actualDate" : "2020-08-20",
"weather" : "Mostly sunny",
"temperatureC" : 26.0,
"temperatureF" : 78.8
}, {
"status" : "Arrived",
"statusCode" : "AR",
"airlineName" : "Aeroflot Russian Airlines",
"airlineCode" : "SU",
"flightNumber" : "3410",
"codeShare" : true,
"operatedFlightNumber" : "1394",
"operatingAirlineName" : "KLM Royal Dutch Airlines",
"operatingAirlineCode" : "KL",
"originAirportName" : "Pulkovo Airport",
"originAirportCode" : "LED",
"originCountryCode" : "RU",
"destinationAirportName" : "Amsterdam Airport Schiphol",
"destinationAirportCode" : "AMS",
"destinationCountryCode" : "NL",
"flight" : "SU 3410",
"delayed" : false,
"airportCode" : "AMS",
"airportName" : "Amsterdam Airport Schiphol",
"gate" : "A9",
"terminal" : "3",
"scheduledTime" : "15:00:00",
"scheduledDate" : "2020-08-20",
"actualTime" : "14:47:00",
"actualDate" : "2020-08-20",
"weather" : "Mostly sunny",
"temperatureC" : 26.0,
"temperatureF" : 78.8
}, {
"status" : "Arrived",
"statusCode" : "AR",
"airlineName" : "Aeroflot Russian Airlines",
"airlineCode" : "SU",
"flightNumber" : "3410",
"codeShare" : true,
"operatedFlightNumber" : "1394",
"operatingAirlineName" : "KLM Royal Dutch Airlines",
"operatingAirlineCode" : "KL",
"originAirportName" : "Pulkovo Airport",
"originAirportCode" : "LED",
"originCountryCode" : "RU",
"destinationAirportName" : "Amsterdam Airport Schiphol",
"destinationAirportCode" : "AMS",
"destinationCountryCode" : "NL",
"flight" : "SU 3410",
"delayed" : false,
"airportCode" : "AMS",
"airportName" : "Amsterdam Airport Schiphol",
"gate" : "A9",
"terminal" : "3",
"scheduledTime" : "15:00:00",
"scheduledDate" : "2020-08-20",
"actualTime" : "14:47:00",
"actualDate" : "2020-08-20",
"weather" : "Mostly sunny",
"temperatureC" : 26.0,
"temperatureF" : 78.8
}, {
"status" : "Arrived",
"statusCode" : "AR",
"airlineName" : "KLM Royal Dutch Airlines",
"airlineCode" : "KL",
"flightNumber" : "1386",
"codeShare" : false,
"operatedFlightNumber" : "1386",
"operatingAirlineName" : "KLM Royal Dutch Airlines",
"operatingAirlineCode" : "KL",
"originAirportName" : "Boryspil International Airport",
"originAirportCode" : "KBP",
"originCountryCode" : "UA",
"destinationAirportName" : "Amsterdam Airport Schiphol",
"destinationAirportCode" : "AMS",
"destinationCountryCode" : "NL",
"flight" : "KL 1386",
"delayed" : false,
"airportCode" : "AMS",
"airportName" : "Amsterdam Airport Schiphol",
"gate" : "A9",
"terminal" : "3",
"scheduledTime" : "15:00:00",
"scheduledDate" : "2020-08-20",
"actualTime" : "14:44:00",
"actualDate" : "2020-08-20",
"codeSharesAsNames" : [ "Ukraine International Airlines 9386", "Delta Air Lines 9473" ],
"codeSharesAsCodes" : [ "PS 9386", "DL 9473" ],
"weather" : "Mostly sunny",
"temperatureC" : 26.0,
"temperatureF" : 78.8
} ]
}
Airline Icon List
The SITA Flight Information Display APIs include Airline Icons for each airline Code. The images are available in 2 formats bullet and gate logo based on image sizes.
For example, AA is represented by a bullet logo in 50x50 size and a gate logo in 65x410 size. Below is the table with Airline Code and URL for corresponding icons.
Contact Us
For subscription and sales queries, please contact:
Product Inquiries
For Technical queries, please contact:
Technical Support Team
