- Publish Flight Information - ACRIS API
- Publish Flight Information - AIDX API
- Publish Flight Information - SITA API
- SITA Flight Connection API
- SITA Flight Duration API
- SITA Flight Follower API
- SITA Flight Schedule API
- SITA Flight Status API
- Overview
- 1 Revision History
- 2 Flight Status API
- 3 SeamlessTravel
- 4 Resources
- 5 Appendix A Status Codes
- 6 Appendix B Flight Status Use Cases
- 7 Appendix C Diverted Flights
- 8 Appendix D Flight Service Type Codes
- Contact Us
- SITA Flight Status Notification API
- SITA Historical Flight Status API
- SITA On Time Performance API
Overview
This API provides flight information and status for flights from airports worldwide for all flights for an airline, arriving or departing, on a particular day. It allows request of flight information for a single (directional) flight or all flights coming in or out of an airport.
Example of information included: arrival/ departure, scheduled/ estimated/ actu.al time, airport Code, terminal, claim, gate, aircraft, marketingCarriers/operatingCarrier, airline, flightNumber, tailNumber; etc.
Flight Status API can provide flight information helpful in answering questions such as:
- Is my flight on time?
- Is my flight delayed?
- Is my flight cancelled?
- What is my departure or arrival gate, baggage claim and terminal?
- What is the likely duration of my flight?
- What type of plane is used on this flight?
For further technical info and examples go to our 'Try it now' or 'Use cases' page.
Need to push your flight data to our service, have a look at our AMS Open specification.
SITA Flight Status API Service
1 Revision History
Date | Document Version | Description |
---|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
2 Flight Status API
2.1 Introduction
The SITA Flight Status API is a REST based service which provides information about flights around the world.
A user may
- Search for the latest flight details based on a combination of airport, airline and flight number details
- Search for flight updates created within a specific time window. These can be at a global level or filtered to an airport/airline/flight number level
- Use the flightId element to uniquely identify a flight in scenarios where multiple flights exist with the same flight number/operation date but different departure/arrival times
2.1.1 Registration and API Sign Up
To access the APIs you will need a registration key, also known as 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.2 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/flifo/flightinfo/oauth/token
endpoint using the OAuth2 Client Credential flow. - Use your API key as the
client_id
, and your consumer secret as theclient_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/flifo/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/flifo/flightinfo/v2/flights/airport/MIA/direction/D?futureWindow=9&view=local' \
--header 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOJIUzI1NiJ9.eyJyZWZyZXNoX3Rva2VuX2V4cGlyZXNfaW4iOiIzNTk5Iiwic3ViIjoic2l0YSIsImFwaV9cm9kdWN0X2xpc3QiOiJbRE9UUy1GbGlnaHQtQ29ubmVjdGlvbi1JbnRlcm5hbF0iLCJpc3MiOiJ1cm46XC9cL2FwaWdlZS1lZdlLUpXVC1wb2xpY3ktdGVzdCIsImFwaV9hY2Nlc3NfdG9rZW4iOiIweXlIZHduSUdtOGo5WlN6WWtuYTBsWG9ZNTFvIiwiYXBpX3JlZnJlc2hfdG9rZW4iOiJraHNlaXN2T3JwSHBUd2NuUVRHdXdBdVdicXNpamNQTyIsImFwaV9zY29wZSI6IiIsImF1ZCI6ImFwaWdlZS1hcGkiLCJleHAiOj3MzAyOTI3MzIsImFwcF9pZCI6IjIxYzI5NTgyLTIwZTktNDkwMS1hNjExLTVkM2UwM2QxNzFkYiIsImV4cGlyZXNfaW4iOiIzNTk5IiwiaWF0IjoxNzMwMjg5MTMyLCJqdGkiOiI3ZmEzNTU4Mi0xNDhmLTRiMmEtODYxMS0wNWI4NDg5YjFjYmMifQ.g_dFH-08DGADOX9HIk7wzX5edxXejVsnCen27A25TQ0'
2.1.3 Security
- All incoming requests will be REST over HTTPS.
- Users are authenticated using their API key.
- Certain response payload elements will be filtered based on permissions associated with the x-apikey value used.
- The API key used in the REST call will be included in the response headers returned to the end user.
2.1.4 Error Response
Response fields
Path | Type | Description |
---|---|---|
|
| Object that holds the error information |
|
| Array of errors |
|
| 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"
} ]
}
}
2.1.5 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.2 Resources
This section describes the Flight Status 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.
2.2.1 FlightInfo V2
2.2.1.1 GET Get Flight by Airline and Flight Number
Retrieve a single flight according to airline and flight number showing both the departure and arrival flight details. Results are filtered by operation date (default is current UTC date).
Payload elements are filtered based on permissions associated with the 'x-apikey' used in the request.
operationDate
In this scenario the operationDate is considered to be the local date on which the flight departed/arrived.
operationDate & searchByUTC
A user can force the operationDate value to be considered as UTC by providing the parameter 'searchByUTC=true'.
Path parameters
Parameter | Description |
---|---|
| 2-character airline IATA code or 3-character airline ICAO code |
| Flight number |
Query parameters
Parameter | Description |
---|---|
| Local date of operation (yyyy-MM-dd). Default value is current UTC date |
| Search based by UTC. Default value is false |
| Include cargo flights. Default value is false |
Request headers
Name | Optional | Description |
---|---|---|
Content-Type | false | Content type of this request. Required value is 'application/json' |
Authorization | false | Authorization header that contains the access token. |
Response fields
Path | Type | Description |
---|---|---|
|
| Flight Records |
|
| Arrival |
|
| The actual local departure/arrival time for this flight e.g 2020-01-22T12:00:00+03:00 |
|
| Airport |
|
| The city in which the airport is located e.g New York |
|
| The city in which the airport is located e.g New York |
|
| 3-character airport IATA code e.g JFK |
|
| 4-character airport ICAO code e.g KJFK |
|
| The name of the airport e.g John F Kennedy International Airport |
|
| Expected carousel(s) for baggage reclaim |
|
| Carousel Slots |
|
| Location details of the slot resource i.e check-in desks1-20, Gate 2C etc |
|
| End time for the slot activity e.g check-in desk closed |
|
| Name used to identify the slot |
|
| Name used to identify the slot internally |
|
| Start time for the slot activity e.g check-in desk opened |
|
| Check-in desk details e.g CK-1 |
|
| Checkin Slots |
|
| Location details of the slot resource i.e check-in desks1-20, Gate 2C etc |
|
| End time for the slot activity e.g check-in desk closed |
|
| Name used to identify the slot |
|
| Name used to identify the slot internally |
|
| Start time for the slot activity e.g check-in desk opened |
|
| Baggage chute details e.g CH-2 |
|
| Chute Slots |
|
| Location details of the slot resource i.e check-in desks1-20, Gate 2C etc |
|
| End time for the slot activity e.g check-in desk closed |
|
| Name used to identify the slot |
|
| Name used to identify the slot internally |
|
| Start time for the slot activity e.g check-in desk opened |
|
| Custom Properties |
|
| Key value used to identify a custom property |
|
| The value of a custom property |
|
| Flight Diversion Details. |
|
| Flight Diversion original record |
|
| Airport |
|
| The city in which the airport is located e.g New York |
|
| The city in which the airport is located e.g New York |
|
| 3-character airport IATA code e.g JFK |
|
| 4-character airport ICAO code e.g KJFK |
|
| The name of the airport e.g John F Kennedy International Airport |
|
| Diversion flight original flight number |
|
| Diversion flight original airline iata code |
|
| Diversion flight original airline icao code |
|
| Diversion flight original airline name |
|
| Diversion flight original scheduled date of operation |
|
| Flight Diversion recovery record |
|
| Airport |
|
| The city in which the airport is located e.g New York |
|
| The city in which the airport is located e.g New York |
|
| 3-character airport IATA code e.g JFK |
|
| 4-character airport ICAO code e.g KJFK |
|
| The name of the airport e.g John F Kennedy International Airport |
|
| Diversion flight recovery flight number |
|
| Diversion flight recovery airline iata code |
|
| Diversion flight recovery airline icao code |
|
| Diversion flight recovery airline name |
|
| Diversion flight recovery scheduled date of operation |
|
| The latest estimated local departure/arrival time for this flight e.g 2020-01-22T12:00:00+03:00 |
|
| Flight events. |
|
| The actual local time at which the aircraft arrived at the gate |
|
| The actual local time at which the aircraft landed on the runway |
|
| The actual local time at which the aircraft left the gate |
|
| The actual local time at which the aircraft left the runway |
|
| The estimated local time at which the aircraft is expected at the gate |
|
| The estimated local time at which the aircraft is expected to land on the runway |
|
| The estimated local time at which the aircraft is expected to leave the gate |
|
| The estimated local time at which the aircraft is expected to leave the runway |
|
| The local time at which the aircraft is targeted to leave the gate |
|
| The local time at which the aircraft is targeted to leave the runway |
|
| The flights departure/arrival gate e.g C1 |
|
| Arrival gate remark |
|
| Gate remark text when applicable e.g Boarding at 21:00 |
|
| Gate Slots |
|
| Location details of the slot resource i.e check-in desks1-20, Gate 2C etc |
|
| End time for the slot activity e.g check-in desk closed |
|
| Name used to identify the slot |
|
| Name used to identify the slot internally |
|
| Start time for the slot activity e.g check-in desk opened |
|
| Route |
|
| 3-character airport IATA code |
|
| 4-character airport ICAO code |
|
| Value used to identify the routes position within an entire flight route e.g leg 0, leg 1, leg 2 etc |
|
| The published scheduled local departure/arrival time for this flight e.g 2020-01-22T12:00:00+03:00 |
|
| Aircraft stand details e.g S12 |
|
| Stand Slots |
|
| Location details of the slot resource i.e check-in desks1-20, Gate 2C etc |
|
| End time for the slot activity e.g check-in desk closed |
|
| Name used to identify the slot |
|
| Name used to identify the slot internally |
|
| Start time for the slot activity e.g check-in desk opened |
|
| The current status code for this flight e.g SC, DP |
|
| The current status text for this flight e.g Scheduled, Departed |
|
| The flights departure/arrival terminal e.g T1 |
|
| Updates |
|
| Current field value |
|
| Previous field value |
|
| UTC timestamp when update was applied |
|
| Payload field which was updated |
|
| FLIFO internal version number |
|
| Departure |
|
| The actual local departure/arrival time for this flight e.g 2020-01-22T12:00:00+03:00 |
|
| Airport |
|
| The city in which the airport is located e.g New York |
|
| The city in which the airport is located e.g New York |
|
| 3-character airport IATA code e.g JFK |
|
| 4-character airport ICAO code e.g KJFK |
|
| The name of the airport e.g John F Kennedy International Airport |
|
| Expected carousel(s) for baggage reclaim |
|
| Carousel Slots |
|
| Location details of the slot resource i.e check-in desks1-20, Gate 2C etc |
|
| End time for the slot activity e.g check-in desk closed |
|
| Name used to identify the slot |
|
| Name used to identify the slot internally |
|
| Start time for the slot activity e.g check-in desk opened |
|
| Check-in desk details e.g CK-1 |
|
| Checkin Slots |
|
| Location details of the slot resource i.e check-in desks1-20, Gate 2C etc |
|
| End time for the slot activity e.g check-in desk closed |
|
| Name used to identify the slot |
|
| Name used to identify the slot internally |
|
| Start time for the slot activity e.g check-in desk opened |
|
| Baggage chute details e.g CH-2 |
|
| Chute Slots |
|
| Location details of the slot resource i.e check-in desks1-20, Gate 2C etc |
|
| End time for the slot activity e.g check-in desk closed |
|
| Name used to identify the slot |
|
| Name used to identify the slot internally |
|
| Start time for the slot activity e.g check-in desk opened |
|
| Custom Properties |
|
| Key value used to identify a custom property |
|
| The value of a custom property |
|
| Flight Diversion Details. |
|
| Flight Diversion original record |
|
| Airport |
|
| The city in which the airport is located e.g New York |
|
| The city in which the airport is located e.g New York |
|
| 3-character airport IATA code e.g JFK |
|
| 4-character airport ICAO code e.g KJFK |
|
| The name of the airport e.g John F Kennedy International Airport |
|
| Diversion flight original flight number |
|
| Diversion flight original airline iata code |
|
| Diversion flight original airline icao code |
|
| Diversion flight original airline name |
|
| Diversion flight original scheduled date of operation |
|
| Flight Diversion recovery record |
|
| Airport |
|
| The city in which the airport is located e.g New York |
|
| The city in which the airport is located e.g New York |
|
| 3-character airport IATA code e.g JFK |
|
| 4-character airport ICAO code e.g KJFK |
|
| The name of the airport e.g John F Kennedy International Airport |
|
| Diversion flight recovery flight number |
|
| Diversion flight recovery airline iata code |
|
| Diversion flight recovery airline icao code |
|
| Diversion flight recovery airline name |
|
| Diversion flight recovery scheduled date of operation |
|
| The latest estimated local departure/arrival time for this flight e.g 2020-01-22T12:00:00+03:00 |
|
| Flight events. |
|
| The actual local time at which the aircraft arrived at the gate |
|
| The actual local time at which the aircraft landed on the runway |
|
| The actual local time at which the aircraft left the gate |
|
| The actual local time at which the aircraft left the runway |
|
| The estimated local time at which the aircraft is expected at the gate |
|
| The estimated local time at which the aircraft is expected to land on the runway |
|
| The estimated local time at which the aircraft is expected to leave the gate |
|
| The estimated local time at which the aircraft is expected to leave the runway |
|
| The local time at which the aircraft is targeted to leave the gate |
|
| The local time at which the aircraft is targeted to leave the runway |
|
| The flights departure/arrival gate e.g C1 |
|
| Departure gate remark |
|
| Gate remark text when applicable e.g Boarding at 21:00 |
|
| Gate Slots |
|
| Location details of the slot resource i.e check-in desks1-20, Gate 2C etc |
|
| End time for the slot activity e.g check-in desk closed |
|
| Name used to identify the slot |
|
| Name used to identify the slot internally |
|
| Start time for the slot activity e.g check-in desk opened |
|
| Route |
|
| 3-character airport IATA code |
|
| 4-character airport ICAO code |
|
| Value used to identify the routes position within an entire flight route e.g leg 0, leg 1, leg 2 etc |
|
| The published scheduled local departure/arrival time for this flight e.g 2020-01-22T12:00:00+03:00 |
|
| Aircraft stand details e.g S12 |
|
| Stand Slots |
|
| Location details of the slot resource i.e check-in desks1-20, Gate 2C etc |
|
| End time for the slot activity e.g check-in desk closed |
|
| Name used to identify the slot |
|
| Name used to identify the slot internally |
|
| Start time for the slot activity e.g check-in desk opened |
|
| The current status code for this flight e.g SC, DP |
|
| The current status text for this flight e.g Scheduled, Departed |
|
| The flights departure/arrival terminal e.g T1 |
|
| Updates |
|
| Current field value |
|
| Previous field value |
|
| UTC timestamp when update was applied |
|
| Payload field which was updated |
|
| FLIFO internal version number |
|
| Flight duration in minutes e.g 60 |
|
| Flight Identifier |
|
| Aircraft |
|
| Callsign for the aircraft type |
|
| IATA code for the aircraft |
|
| ICAO code for the aircraft |
|
| Specific aircraft model details |
|
| Aircraft regristration/tail number details e.g EIAA44W |
|
| A value that uniquely identifies a flight within the system |
|
| Marketing Carriers |
|
| Flight number e.g 1234 |
|
| 2-character airline IATA code e.g AA |
|
| 3-character airline ICAO code e.g AAL |
|
| Name of airline e.g American Airlines |
|
| Operating Carrier |
|
| Flight number e.g 1234 |
|
| 2-character airline IATA code e.g AA |
|
| 3-character airline ICAO code e.g AAL |
|
| Name of airline e.g American Airlines |
|
| Flight Stats |
|
| Baggage |
|
| Total number of cargo pieces |
|
| Total number of bags/pieces |
|
| Load breakdown |
|
| Total number of mail pieces |
|
| Total weight of bags/pieces |
|
| Passengers |
|
| Actual number of business class passengers |
|
| Actual number of economy class passengers |
|
| Actual number of 1st class passengers |
|
| Actual number of passengers |
|
| Actual number of transfer passengers |
|
| Actual number of transit passengers |
|
| Total number of adults |
|
| Total number of booked business class passengers |
|
| Total number of booked economy class passengers |
|
| Total number of booked 1st class passengers |
|
| Total number of booked passengers |
|
| Total number of children |
|
| Total number of infants |
|
| Total number of reduced mobility passengers e.g those requiring assistance boarding the aircraft etc. |
|
| UTC timestamp when last update update was applied to this flight |
|
| Data source of the last update applied to this flight |
|
| Flight service type e.g J-Passenger, F-Cargo |
Curl request
$ curl 'https://flifo.api.aero/flifo/flightinfo/v2/flights/airline/KL/flightNumber/1394?operationDate=2020-01-22' -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: 5401
{
"flightRecords" : [ {
"flightIdentifier" : {
"operatingCarrier" : {
"iataCode" : "KL",
"flightNumber" : "1394",
"name" : "KLM Royal Dutch Airlines"
},
"aircraft" : {
"iataCode" : "73H",
"registration" : "PHBXG"
},
"flightId" : "12345678"
},
"flightStats" : {
"passengers" : {
"bookedTotal" : "100",
"bookedFirst" : "4",
"bookedBusiness" : "16",
"bookedEconomy" : "106",
"actualTotal" : "100",
"actualFirst" : "4",
"actualBusiness" : "16",
"actualEconomy" : "4",
"actualTransfer" : "100",
"actualTransit" : "100",
"reducedMobility" : "0",
"adult" : "60",
"child" : "15",
"infant" : "5"
},
"baggage" : {
"count" : "50",
"load" : "50000",
"totalWeight" : "500",
"cargo" : "20",
"mail" : "30"
}
},
"departure" : {
"airport" : {
"iataCode" : "LED",
"cityText" : "St. Petersburg"
},
"scheduled" : "2020-01-22T12:00:00+03:00",
"status" : "SC",
"statusText" : "Scheduled",
"terminal" : "3",
"gate" : "10E",
"carousel" : "10E",
"stand" : "440E",
"checkIn" : "10E",
"chute" : "10E",
"standSlots" : [ {
"name" : "4O",
"externalName" : "4OE",
"startTime" : "2020-01-22T06:00:00+03:00",
"endTime" : "2020-01-22T08:00:00+03:00",
"area" : "A"
} ],
"checkinSlots" : [ {
"name" : "1O",
"externalName" : "1OE",
"startTime" : "2020-01-22T06:00:00+03:00",
"endTime" : "2020-01-22T08:00:00+03:00"
} ],
"carouselSlots" : [ {
"name" : "1O",
"externalName" : "1OE",
"startTime" : "2020-01-22T06:00:00+03:00",
"endTime" : "2020-01-22T08:00:00+03:00"
} ],
"gateSlots" : [ {
"name" : "10",
"externalName" : "10E",
"startTime" : "2020-01-22T06:00:00+03:00",
"endTime" : "2020-01-22T08:00:00+03:00"
} ],
"chuteSlots" : [ {
"name" : "10",
"externalName" : "10E",
"startTime" : "2020-01-22T06:00:00+03:00",
"endTime" : "2020-01-22T08:00:00+03:00"
} ],
"route" : [ {
"iataCode" : "DUB",
"icaoCode" : "EIDW",
"sequenceNumber" : "0"
} ],
"customProperties" : [ {
"key" : "mycustomkey",
"value" : "newcustomvalue"
} ],
"events" : {
"ALDT" : "2020-01-22T12:15:00+03:00",
"AIBT" : "2020-01-22T12:15:00+03:00",
"AOBT" : "2020-01-22T12:15:00+03:00",
"ATOT" : "2020-01-22T12:15:00+03:00",
"ELDT" : "2020-01-22T12:15:00+03:00",
"EIBT" : "2020-01-22T12:15:00+03:00",
"EOBT" : "2020-01-22T12:15:00+03:00",
"ETOT" : "2020-01-22T12:15:00+03:00",
"TOBT" : "2020-01-22T12:15:00+03:00",
"TTOT" : "2020-01-22T12:15:00+03:00"
}
},
"arrival" : {
"airport" : {
"iataCode" : "AMS",
"cityText" : "Amsterdam"
},
"scheduled" : "2020-01-22T16:00:00+01:00",
"estimated" : "2020-01-22T15:47:00+01:00",
"actual" : "2020-01-22T15:47:00+01:00",
"status" : "AR",
"statusText" : "Arrived",
"terminal" : "3",
"gate" : "10E",
"carousel" : "10E",
"stand" : "440E",
"checkIn" : "10E",
"chute" : "10E",
"standSlots" : [ {
"name" : "4O",
"externalName" : "4OE",
"startTime" : "2020-01-22T06:00:00+01:00",
"endTime" : "2020-01-22T08:00:00+01:00",
"area" : "A"
} ],
"checkinSlots" : [ {
"name" : "1O",
"externalName" : "1OE",
"startTime" : "2020-01-22T06:00:00+01:00",
"endTime" : "2020-01-22T08:00:00+01:00"
} ],
"carouselSlots" : [ {
"name" : "1O",
"externalName" : "1OE",
"startTime" : "2020-01-22T06:00:00+01:00",
"endTime" : "2020-01-22T08:00:00+01:00"
} ],
"gateSlots" : [ {
"name" : "10",
"externalName" : "10E",
"startTime" : "2020-01-22T06:00:00+01:00",
"endTime" : "2020-01-22T08:00:00+01:00"
} ],
"chuteSlots" : [ {
"name" : "10",
"externalName" : "10E",
"startTime" : "2020-01-22T06:00:00+01:00",
"endTime" : "2020-01-22T08:00:00+01:00"
} ],
"route" : [ {
"iataCode" : "DUB",
"icaoCode" : "EIDW",
"sequenceNumber" : "0"
} ],
"customProperties" : [ {
"key" : "mycustomkey",
"value" : "newcustomvalue"
} ],
"events" : {
"ALDT" : "2020-01-22T12:15:00+01:00",
"AIBT" : "2020-01-22T12:15:00+01:00",
"AOBT" : "2020-01-22T12:15:00+01:00",
"ATOT" : "2020-01-22T12:15:00+01:00",
"ELDT" : "2020-01-22T12:15:00+01:00",
"EIBT" : "2020-01-22T12:15:00+01:00",
"EOBT" : "2020-01-22T12:15:00+01:00",
"ETOT" : "2020-01-22T12:15:00+01:00",
"TOBT" : "2020-01-22T12:15:00+01:00",
"TTOT" : "2020-01-22T12:15:00+01:00"
}
},
"serviceType" : "J",
"duration" : "360"
} ]
}
2.2.1.2 GET Get Flights by Airport, Airline and Direction
Retrieve all flights arriving to or departing from a specified airport for a given airline. Results are filtered by operation date (default is current UTC date).
Payload elements are filtered based on permissions associated with the 'x-apikey' used in the request.
operationDate
If the operation date is not provided the search is based on the current UTC date/time. The search window will be current UTC date/time → current UTC date/time + 4 hours (futureWindow default value).
The user can adjust the search window by providing values for the pastWindow/futureWindow in their request.
The operationDate (in addition to the futureWindow if also provided) should not exceed 14 days of the current UTC date.
If the operation date is provided the search window will be operationDate (00:00:00) → operationDate + 4 hours (futureWindow default value) e.g. 2021-01-12 00:00:00 → 2021-01-12 04:00:00.
In this scenario the operationDate is considered to be the local date/datetime on which the flight departed/arrived.
The user can adjust the search window by providing values for the pastWindow/futureWindow in their request.
operationDate & searchByUTC
A user can force the operationDate value to be considered as UTC by providing the parameter 'searchByUTC=true'. By doing so the user has the ability to search for flights in the past/future based on UTC date/time.
Path parameters
Parameter | Description |
---|---|
| 3-character airport IATA code or 4-character airport ICAO code |
| 2-character airline IATA code or 3-character airline ICAO code |
| 1-character direction indicator (A/D) |
Query parameters
Parameter | Description |
---|---|
| Local date/datetime of operation (yyyy-MM-dd or yyyy-MM-ddTHH:mm:ss). Default value is current UTC date |
| Hours in past to return. Default value is 0 |
| Hours in future to return. Default value is 4 |
| Search based by UTC. Default value is false |
| Include cargo flights. Default value is false |
| Group marketing and operating carrier flights into a single record. Default value is false |
| Filter results based on origin or destination airport |
| View 'full' or 'local' leg, based on direction. Default value is local. See notes for further details. |
Request headers
Name | Optional | Description |
---|---|---|
Content-Type | false | Content type of this request. Required value is 'application/json' |
Authorization | false | Authorization header that contains the access token. |
Response fields
Path | Type | Description |
---|---|---|
|
| Flight Records |
|
| Arrival |
|
| The actual local departure/arrival time for this flight e.g 2020-01-22T12:00:00+03:00 |
|
| Airport |
|
| The city in which the airport is located e.g New York |
|
| The city in which the airport is located e.g New York |
|
| 3-character airport IATA code e.g JFK |
|
| 4-character airport ICAO code e.g KJFK |
|
| The name of the airport e.g John F Kennedy International Airport |
|
| Expected carousel(s) for baggage reclaim |
|
| Carousel Slots |
|
| Location details of the slot resource i.e check-in desks1-20, Gate 2C etc |
|
| End time for the slot activity e.g check-in desk closed |
|
| Name used to identify the slot |
|
| Name used to identify the slot internally |
|
| Start time for the slot activity e.g check-in desk opened |
|
| Check-in desk details e.g CK-1 |
|
| Checkin Slots |
|
| Location details of the slot resource i.e check-in desks1-20, Gate 2C etc |
|
| End time for the slot activity e.g check-in desk closed |
|
| Name used to identify the slot |
|
| Name used to identify the slot internally |
|
| Start time for the slot activity e.g check-in desk opened |
|
| Baggage chute details e.g CH-2 |
|
| Chute Slots |
|
| Location details of the slot resource i.e check-in desks1-20, Gate 2C etc |
|
| End time for the slot activity e.g check-in desk closed |
|
| Name used to identify the slot |
|
| Name used to identify the slot internally |
|
| Start time for the slot activity e.g check-in desk opened |
|
| Custom Properties |
|
| Key value used to identify a custom property |
|
| The value of a custom property |
|
| Flight Diversion Details. |
|
| Flight Diversion original record |
|
| Airport |
|
| The city in which the airport is located e.g New York |
|
| The city in which the airport is located e.g New York |
|
| 3-character airport IATA code e.g JFK |
|
| 4-character airport ICAO code e.g KJFK |
|
| The name of the airport e.g John F Kennedy International Airport |
|
| Diversion flight original flight number |
|
| Diversion flight original airline iata code |
|
| Diversion flight original airline icao code |
|
| Diversion flight original airline name |
|
| Diversion flight original scheduled date of operation |
|
| Flight Diversion recovery record |
|
| Airport |
|
| The city in which the airport is located e.g New York |
|
| The city in which the airport is located e.g New York |
|
| 3-character airport IATA code e.g JFK |
|
| 4-character airport ICAO code e.g KJFK |
|
| The name of the airport e.g John F Kennedy International Airport |
|
| Diversion flight recovery flight number |
|
| Diversion flight recovery airline iata code |
|
| Diversion flight recovery airline icao code |
|
| Diversion flight recovery airline name |
|
| Diversion flight recovery scheduled date of operation |
|
| The latest estimated local departure/arrival time for this flight e.g 2020-01-22T12:00:00+03:00 |
|
| Flight events. |
|
| The actual local time at which the aircraft arrived at the gate |
|
| The actual local time at which the aircraft landed on the runway |
|
| The actual local time at which the aircraft left the gate |
|
| The actual local time at which the aircraft left the runway |
|
| The estimated local time at which the aircraft is expected at the gate |
|
| The estimated local time at which the aircraft is expected to land on the runway |
|
| The estimated local time at which the aircraft is expected to leave the gate |
|
| The estimated local time at which the aircraft is expected to leave the runway |
|
| The local time at which the aircraft is targeted to leave the gate |
|
| The local time at which the aircraft is targeted to leave the runway |
|
| The flights departure/arrival gate e.g C1 |
|
| Arrival gate remark |
|
| Gate remark text when applicable e.g Boarding at 21:00 |
|
| Gate Slots |
|
| Location details of the slot resource i.e check-in desks1-20, Gate 2C etc |
|
| End time for the slot activity e.g check-in desk closed |
|
| Name used to identify the slot |
|
| Name used to identify the slot internally |
|
| Start time for the slot activity e.g check-in desk opened |
|
| Route |
|
| 3-character airport IATA code |
|
| 4-character airport ICAO code |
|
| Value used to identify the routes position within an entire flight route e.g leg 0, leg 1, leg 2 etc |
|
| The published scheduled local departure/arrival time for this flight e.g 2020-01-22T12:00:00+03:00 |
|
| Aircraft stand details e.g S12 |
|
| Stand Slots |
|
| Location details of the slot resource i.e check-in desks1-20, Gate 2C etc |
|
| End time for the slot activity e.g check-in desk closed |
|
| Name used to identify the slot |
|
| Name used to identify the slot internally |
|
| Start time for the slot activity e.g check-in desk opened |
|
| The current status code for this flight e.g SC, DP |
|
| The current status text for this flight e.g Scheduled, Departed |
|
| The flights departure/arrival terminal e.g T1 |
|
| Updates |
|
| Current field value |
|
| Previous field value |
|
| UTC timestamp when update was applied |
|
| Payload field which was updated |
|
| FLIFO internal version number |
|
| Departure |
|
| The actual local departure/arrival time for this flight e.g 2020-01-22T12:00:00+03:00 |
|
| Airport |
|
| The city in which the airport is located e.g New York |
|
| The city in which the airport is located e.g New York |
|
| 3-character airport IATA code e.g JFK |
|
| 4-character airport ICAO code e.g KJFK |
|
| The name of the airport e.g John F Kennedy International Airport |
|
| Expected carousel(s) for baggage reclaim |
|
| Carousel Slots |
|
| Location details of the slot resource i.e check-in desks1-20, Gate 2C etc |
|
| End time for the slot activity e.g check-in desk closed |
|
| Name used to identify the slot |
|
| Name used to identify the slot internally |
|
| Start time for the slot activity e.g check-in desk opened |
|
| Check-in desk details e.g CK-1 |
|
| Checkin Slots |
|
| Location details of the slot resource i.e check-in desks1-20, Gate 2C etc |
|
| End time for the slot activity e.g check-in desk closed |
|
| Name used to identify the slot |
|
| Name used to identify the slot internally |
|
| Start time for the slot activity e.g check-in desk opened |
|
| Baggage chute details e.g CH-2 |
|
| Chute Slots |
|
| Location details of the slot resource i.e check-in desks1-20, Gate 2C etc |
|
| End time for the slot activity e.g check-in desk closed |
|
| Name used to identify the slot |
|
| Name used to identify the slot internally |
|
| Start time for the slot activity e.g check-in desk opened |
|
| Custom Properties |
|
| Key value used to identify a custom property |
|
| The value of a custom property |
|
| Flight Diversion Details. |
|
| Flight Diversion original record |
|
| Airport |
|
| The city in which the airport is located e.g New York |
|
| The city in which the airport is located e.g New York |
|
| 3-character airport IATA code e.g JFK |
|
| 4-character airport ICAO code e.g KJFK |
|
| The name of the airport e.g John F Kennedy International Airport |
|
| Diversion flight original flight number |
|
| Diversion flight original airline iata code |
|
| Diversion flight original airline icao code |
|
| Diversion flight original airline name |
|
| Diversion flight original scheduled date of operation |
|
| Flight Diversion recovery record |
|
| Airport |
|
| The city in which the airport is located e.g New York |
|
| The city in which the airport is located e.g New York |
|
| 3-character airport IATA code e.g JFK |
|
| 4-character airport ICAO code e.g KJFK |
|
| The name of the airport e.g John F Kennedy International Airport |
|
| Diversion flight recovery flight number |
|
| Diversion flight recovery airline iata code |
|
| Diversion flight recovery airline icao code |
|
| Diversion flight recovery airline name |
|
| Diversion flight recovery scheduled date of operation |
|
| The latest estimated local departure/arrival time for this flight e.g 2020-01-22T12:00:00+03:00 |
|
| Flight events. |
|
| The actual local time at which the aircraft arrived at the gate |
|
| The actual local time at which the aircraft landed on the runway |
|
| The actual local time at which the aircraft left the gate |
|
| The actual local time at which the aircraft left the runway |
|
| The estimated local time at which the aircraft is expected at the gate |
|
| The estimated local time at which the aircraft is expected to land on the runway |
|
| The estimated local time at which the aircraft is expected to leave the gate |
|
| The estimated local time at which the aircraft is expected to leave the runway |
|
| The local time at which the aircraft is targeted to leave the gate |
|
| The local time at which the aircraft is targeted to leave the runway |
|
| The flights departure/arrival gate e.g C1 |
|
| Departure gate remark |
|
| Gate remark text when applicable e.g Boarding at 21:00 |
|
| Gate Slots |
|
| Location details of the slot resource i.e check-in desks1-20, Gate 2C etc |
|
| End time for the slot activity e.g check-in desk closed |
|
| Name used to identify the slot |
|
| Name used to identify the slot internally |
|
| Start time for the slot activity e.g check-in desk opened |
|
| Route |
|
| 3-character airport IATA code |
|
| 4-character airport ICAO code |
|
| Value used to identify the routes position within an entire flight route e.g leg 0, leg 1, leg 2 etc |
|
| The published scheduled local departure/arrival time for this flight e.g 2020-01-22T12:00:00+03:00 |
|
| Aircraft stand details e.g S12 |
|
| Stand Slots |
|
| Location details of the slot resource i.e check-in desks1-20, Gate 2C etc |
|
| End time for the slot activity e.g check-in desk closed |
|
| Name used to identify the slot |
|
| Name used to identify the slot internally |
|
| Start time for the slot activity e.g check-in desk opened |
|
| The current status code for this flight e.g SC, DP |
|
| The current status text for this flight e.g Scheduled, Departed |
|
| The flights departure/arrival terminal e.g T1 |
|
| Updates |
|
| Current field value |
|
| Previous field value |
|
| UTC timestamp when update was applied |
|
| Payload field which was updated |
|
| FLIFO internal version number |
|
| Flight duration in minutes e.g 60 |
|
| Flight Identifier |
|
| Aircraft |
|
| Callsign for the aircraft type |
|
| IATA code for the aircraft |
|
| ICAO code for the aircraft |
|
| Specific aircraft model details |
|
| Aircraft regristration/tail number details e.g EIAA44W |
|
| A value that uniquely identifies a flight within the system |
|
| Marketing Carriers |
|
| Flight number e.g 1234 |
|
| 2-character airline IATA code e.g AA |
|
| 3-character airline ICAO code e.g AAL |
|
| Name of airline e.g American Airlines |
|
| Operating Carrier |
|
| Flight number e.g 1234 |
|
| 2-character airline IATA code e.g AA |
|
| 3-character airline ICAO code e.g AAL |
|
| Name of airline e.g American Airlines |
|
| Flight Stats |
|
| Baggage |
|
| Total number of cargo pieces |
|
| Total number of bags/pieces |
|
| Load breakdown |
|
| Total number of mail pieces |
|
| Total weight of bags/pieces |
|
| Passengers |
|
| Actual number of business class passengers |
|
| Actual number of economy class passengers |
|
| Actual number of 1st class passengers |
|
| Actual number of passengers |
|
| Actual number of transfer passengers |
|
| Actual number of transit passengers |
|
| Total number of adults |
|
| Total number of booked business class passengers |
|
| Total number of booked economy class passengers |
|
| Total number of booked 1st class passengers |
|
| Total number of booked passengers |
|
| Total number of children |
|
| Total number of infants |
|
| Total number of reduced mobility passengers e.g those requiring assistance boarding the aircraft etc. |
|
| UTC timestamp when last update update was applied to this flight |
|
| Data source of the last update applied to this flight |
|
| Flight service type e.g J-Passenger, F-Cargo |
Curl request
$ curl 'https://flifo.api.aero/flifo/flightinfo/v2/flights/airport/AMS/airline/KL/direction/A?operationDate=2020-01-22T12:00:00' -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: 10903
{
"flightRecords" : [ {
"flightIdentifier" : {
"operatingCarrier" : {
"iataCode" : "KL",
"flightNumber" : "1146",
"name" : "KLM Royal Dutch Airlines"
},
"marketingCarriers" : [ {
"iataCode" : "DL",
"flightNumber" : "9598",
"name" : "Delta Air Lines"
} ],
"aircraft" : {
"iataCode" : "EMJ",
"registration" : "PHEZH"
},
"flightId" : "12345678"
},
"flightStats" : {
"passengers" : {
"bookedTotal" : "100",
"bookedFirst" : "4",
"bookedBusiness" : "16",
"bookedEconomy" : "106",
"actualTotal" : "100",
"actualFirst" : "4",
"actualBusiness" : "16",
"actualEconomy" : "4",
"actualTransfer" : "100",
"actualTransit" : "100",
"reducedMobility" : "0",
"adult" : "60",
"child" : "15",
"infant" : "5"
},
"baggage" : {
"count" : "50",
"load" : "50000",
"totalWeight" : "500",
"cargo" : "20",
"mail" : "30"
}
},
"departure" : {
"airport" : {
"iataCode" : "OSL",
"cityText" : "Oslo"
},
"scheduled" : "2020-01-22T12:00:00+01:00",
"status" : "SC",
"statusText" : "Scheduled",
"terminal" : "2",
"gate" : "10E",
"carousel" : "10E",
"stand" : "440E",
"checkIn" : "10E",
"chute" : "10E",
"standSlots" : [ {
"name" : "4O",
"externalName" : "4OE",
"startTime" : "2020-01-22T06:00:00+01:00",
"endTime" : "2020-01-22T08:00:00+01:00",
"area" : "A"
} ],
"checkinSlots" : [ {
"name" : "1O",
"externalName" : "1OE",
"startTime" : "2020-01-22T06:00:00+01:00",
"endTime" : "2020-01-22T08:00:00+01:00"
} ],
"carouselSlots" : [ {
"name" : "1O",
"externalName" : "1OE",
"startTime" : "2020-01-22T06:00:00+01:00",
"endTime" : "2020-01-22T08:00:00+01:00"
} ],
"gateSlots" : [ {
"name" : "10",
"externalName" : "10E",
"startTime" : "2020-01-22T06:00:00+01:00",
"endTime" : "2020-01-22T08:00:00+01:00"
} ],
"chuteSlots" : [ {
"name" : "10",
"externalName" : "10E",
"startTime" : "2020-01-22T06:00:00+01:00",
"endTime" : "2020-01-22T08:00:00+01:00"
} ],
"route" : [ {
"iataCode" : "DUB",
"icaoCode" : "EIDW",
"sequenceNumber" : "0"
} ],
"customProperties" : [ {
"key" : "mycustomkey",
"value" : "newcustomvalue"
} ],
"events" : {
"ALDT" : "2020-01-22T12:15:00+01:00",
"AIBT" : "2020-01-22T12:15:00+01:00",
"AOBT" : "2020-01-22T12:15:00+01:00",
"ATOT" : "2020-01-22T12:15:00+01:00",
"ELDT" : "2020-01-22T12:15:00+01:00",
"EIBT" : "2020-01-22T12:15:00+01:00",
"EOBT" : "2020-01-22T12:15:00+01:00",
"ETOT" : "2020-01-22T12:15:00+01:00",
"TOBT" : "2020-01-22T12:15:00+01:00",
"TTOT" : "2020-01-22T12:15:00+01:00"
}
},
"arrival" : {
"airport" : {
"iataCode" : "AMS",
"cityText" : "Amsterdam"
},
"scheduled" : "2020-01-22T16:00:00+01:00",
"estimated" : "2020-01-22T16:03:00+01:00",
"actual" : "2020-01-22T16:03:00+01:00",
"status" : "AR",
"statusText" : "Arrived",
"terminal" : "2",
"gate" : "A4",
"carousel" : "10E",
"stand" : "40E",
"checkIn" : "10E",
"chute" : "10E",
"standSlots" : [ {
"name" : "4O",
"externalName" : "4OE",
"startTime" : "2020-01-22T06:00:00+01:00",
"endTime" : "2020-01-22T08:00:00+01:00",
"area" : "A"
} ],
"checkinSlots" : [ {
"name" : "1O",
"externalName" : "1OE",
"startTime" : "2020-01-22T06:00:00+01:00",
"endTime" : "2020-01-22T08:00:00+01:00"
} ],
"carouselSlots" : [ {
"name" : "1O",
"externalName" : "1OE",
"startTime" : "2020-01-22T06:00:00+01:00",
"endTime" : "2020-01-22T08:00:00+01:00"
} ],
"gateSlots" : [ {
"name" : "A",
"externalName" : "A4",
"startTime" : "2020-01-22T06:00:00+01:00",
"endTime" : "2020-01-22T08:00:00+01:00"
} ],
"chuteSlots" : [ {
"name" : "10",
"externalName" : "10E",
"startTime" : "2020-01-22T06:00:00+01:00",
"endTime" : "2020-01-22T08:00:00+01:00"
} ],
"route" : [ {
"iataCode" : "DUB",
"icaoCode" : "EIDW",
"sequenceNumber" : "0"
} ],
"customProperties" : [ {
"key" : "mycustomkey",
"value" : "newcustomvalue"
} ],
"events" : {
"ALDT" : "2020-01-22T16:01:00+01:00",
"AIBT" : "2020-01-22T16:01:00+01:00",
"AOBT" : "2020-01-22T16:01:00+01:00",
"ATOT" : "2020-01-22T16:01:00+01:00",
"ELDT" : "2020-01-22T16:01:00+01:00",
"EIBT" : "2020-01-22T16:01:00+01:00",
"EOBT" : "2020-01-22T16:01:00+01:00",
"ETOT" : "2020-01-22T16:01:00+01:00",
"TOBT" : "2020-01-22T16:01:00+01:00",
"TTOT" : "2020-01-22T16:01:00+01:00"
}
},
"serviceType" : "J",
"duration" : "240"
}, {
"flightIdentifier" : {
"operatingCarrier" : {
"iataCode" : "KL",
"flightNumber" : "1394",
"name" : "KLM Royal Dutch Airlines"
},
"aircraft" : {
"iataCode" : "73H",
"registration" : "PHBXG"
},
"flightId" : "12345678"
},
"flightStats" : {
"passengers" : {
"bookedTotal" : "100",
"bookedFirst" : "4",
"bookedBusiness" : "16",
"bookedEconomy" : "106",
"actualTotal" : "100",
"actualFirst" : "4",
"actualBusiness" : "16",
"actualEconomy" : "4",
"actualTransfer" : "100",
"actualTransit" : "100",
"reducedMobility" : "0",
"adult" : "60",
"child" : "15",
"infant" : "5"
},
"baggage" : {
"count" : "50",
"load" : "50000",
"totalWeight" : "500",
"cargo" : "20",
"mail" : "30"
}
},
"departure" : {
"airport" : {
"iataCode" : "LED",
"cityText" : "St. Petersburg"
},
"scheduled" : "2020-01-22T12:00:00+03:00",
"status" : "SC",
"statusText" : "Scheduled",
"terminal" : "3",
"gate" : "10E",
"carousel" : "10E",
"stand" : "440E",
"checkIn" : "10E",
"chute" : "10E",
"standSlots" : [ {
"name" : "4O",
"externalName" : "4OE",
"startTime" : "2020-01-22T06:00:00+03:00",
"endTime" : "2020-01-22T08:00:00+03:00",
"area" : "A"
} ],
"checkinSlots" : [ {
"name" : "1O",
"externalName" : "1OE",
"startTime" : "2020-01-22T06:00:00+03:00",
"endTime" : "2020-01-22T08:00:00+03:00"
} ],
"carouselSlots" : [ {
"name" : "1O",
"externalName" : "1OE",
"startTime" : "2020-01-22T06:00:00+03:00",
"endTime" : "2020-01-22T08:00:00+03:00"
} ],
"gateSlots" : [ {
"name" : "10",
"externalName" : "10E",
"startTime" : "2020-01-22T06:00:00+03:00",
"endTime" : "2020-01-22T08:00:00+03:00"
} ],
"chuteSlots" : [ {
"name" : "10",
"externalName" : "10E",
"startTime" : "2020-01-22T06:00:00+03:00",
"endTime" : "2020-01-22T08:00:00+03:00"
} ],
"route" : [ {
"iataCode" : "DUB",
"icaoCode" : "EIDW",
"sequenceNumber" : "0"
} ],
"customProperties" : [ {
"key" : "mycustomkey",
"value" : "newcustomvalue"
} ],
"events" : {
"ALDT" : "2020-01-22T12:15:00+03:00",
"AIBT" : "2020-01-22T12:15:00+03:00",
"AOBT" : "2020-01-22T12:15:00+03:00",
"ATOT" : "2020-01-22T12:15:00+03:00",
"ELDT" : "2020-01-22T12:15:00+03:00",
"EIBT" : "2020-01-22T12:15:00+03:00",
"EOBT" : "2020-01-22T12:15:00+03:00",
"ETOT" : "2020-01-22T12:15:00+03:00",
"TOBT" : "2020-01-22T12:15:00+03:00",
"TTOT" : "2020-01-22T12:15:00+03:00"
}
},
"arrival" : {
"airport" : {
"iataCode" : "AMS",
"cityText" : "Amsterdam"
},
"scheduled" : "2020-01-22T16:00:00+01:00",
"estimated" : "2020-01-22T15:47:00+01:00",
"actual" : "2020-01-22T15:47:00+01:00",
"status" : "AR",
"statusText" : "Arrived",
"terminal" : "3",
"gate" : "10E",
"carousel" : "10E",
"stand" : "440E",
"checkIn" : "10E",
"chute" : "10E",
"standSlots" : [ {
"name" : "4O",
"externalName" : "4OE",
"startTime" : "2020-01-22T06:00:00+01:00",
"endTime" : "2020-01-22T08:00:00+01:00",
"area" : "A"
} ],
"checkinSlots" : [ {
"name" : "1O",
"externalName" : "1OE",
"startTime" : "2020-01-22T06:00:00+01:00",
"endTime" : "2020-01-22T08:00:00+01:00"
} ],
"carouselSlots" : [ {
"name" : "1O",
"externalName" : "1OE",
"startTime" : "2020-01-22T06:00:00+01:00",
"endTime" : "2020-01-22T08:00:00+01:00"
} ],
"gateSlots" : [ {
"name" : "10",
"externalName" : "10E",
"startTime" : "2020-01-22T06:00:00+01:00",
"endTime" : "2020-01-22T08:00:00+01:00"
} ],
"chuteSlots" : [ {
"name" : "10",
"externalName" : "10E",
"startTime" : "2020-01-22T06:00:00+01:00",
"endTime" : "2020-01-22T08:00:00+01:00"
} ],
"route" : [ {
"iataCode" : "DUB",
"icaoCode" : "EIDW",
"sequenceNumber" : "0"
} ],
"customProperties" : [ {
"key" : "mycustomkey",
"value" : "newcustomvalue"
} ],
"events" : {
"ALDT" : "2020-01-22T12:15:00+01:00",
"AIBT" : "2020-01-22T12:15:00+01:00",
"AOBT" : "2020-01-22T12:15:00+01:00",
"ATOT" : "2020-01-22T12:15:00+01:00",
"ELDT" : "2020-01-22T12:15:00+01:00",
"EIBT" : "2020-01-22T12:15:00+01:00",
"EOBT" : "2020-01-22T12:15:00+01:00",
"ETOT" : "2020-01-22T12:15:00+01:00",
"TOBT" : "2020-01-22T12:15:00+01:00",
"TTOT" : "2020-01-22T12:15:00+01:00"
}
},
"serviceType" : "J",
"duration" : "360"
} ]
}
2.2.1.3 GET Get Flights by Airport and Direction
Retrieve all flights arriving to or departing from a specific airport. Results are filtered by operation date (default is current UTC date).
Payload elements are filtered based on permissions associated with the 'x-apikey' used in the request.
operationDate
If the operation date is not provided the search is based on the current UTC date/time. The search window will be current UTC date/time → current UTC date/time + 4 hours (futureWindow default value).
The user can adjust the search window by providing values for the pastWindow/futureWindow in their request.
The operationDate (in addition to the futureWindow if also provided) should not exceed 14 days of the current UTC date.
If the operation date is provided the search window will be operationDate (00:00:00) → operationDate + 4 hours (futureWindow default value) e.g. 2021-01-12 00:00:00 → 2021-01-12 04:00:00.
In this scenario the operationDate is considered to be the local date/datetime on which the flight departed/arrived.
The user can adjust the search window by providing values for the pastWindow/futureWindow in their request.
operationDate & searchByUTC
A user can force the operationDate value to be considered as UTC by providing the parameter 'searchByUTC=true'. By doing so the user has the ability to search for flights in the past/future based on UTC date/time.
Path parameters
Parameter | Description |
---|---|
| 3-character airport IATA code or 4-character airport ICAO code |
| 1-character direction indicator (A/D) |
Query parameters
Parameter | Description |
---|---|
| Local date/datetime of operation (yyyy-MM-dd or yyyy-MM-ddTHH:mm:ss). Default value is current UTC date |
| Hours in past to return. Default value is 0 |
| Hours in future to return. Default value is 4 |
| Search based by UTC. Default value is false |
| Include cargo flights. Default value is false |
| Group marketing and operating carrier flights into a single record. Default value is false |
| Filter results based on origin or destination airport |
| View 'full' or 'local' leg, based on direction. Default value is local. See notes for further details. |
Request headers
Name | Optional | Description |
---|---|---|
Content-Type | false | Content type of this request. Required value is 'application/json' |
Authorization | false | Authorization header that contains the access token. |
Response fields
Path | Type | Description |
---|---|---|
|
| Flight Records |
|
| Arrival |
|
| The actual local departure/arrival time for this flight e.g 2020-01-22T12:00:00+03:00 |
|
| Airport |
|
| The city in which the airport is located e.g New York |
|
| The city in which the airport is located e.g New York |
|
| 3-character airport IATA code e.g JFK |
|
| 4-character airport ICAO code e.g KJFK |
|
| The name of the airport e.g John F Kennedy International Airport |
|
| Expected carousel(s) for baggage reclaim |
|
| Carousel Slots |
|
| Location details of the slot resource i.e check-in desks1-20, Gate 2C etc |
|
| End time for the slot activity e.g check-in desk closed |
|
| Name used to identify the slot |
|
| Name used to identify the slot internally |
|
| Start time for the slot activity e.g check-in desk opened |
|
| Check-in desk details e.g CK-1 |
|
| Checkin Slots |
|
| Location details of the slot resource i.e check-in desks1-20, Gate 2C etc |
|
| End time for the slot activity e.g check-in desk closed |
|
| Name used to identify the slot |
|
| Name used to identify the slot internally |
|
| Start time for the slot activity e.g check-in desk opened |
|
| Baggage chute details e.g CH-2 |
|
| Chute Slots |
|
| Location details of the slot resource i.e check-in desks1-20, Gate 2C etc |
|
| End time for the slot activity e.g check-in desk closed |
|
| Name used to identify the slot |
|
| Name used to identify the slot internally |
|
| Start time for the slot activity e.g check-in desk opened |
|
| Custom Properties |
|
| Key value used to identify a custom property |
|
| The value of a custom property |
|
| Flight Diversion Details. |
|
| Flight Diversion original record |
|
| Airport |
|
| The city in which the airport is located e.g New York |
|
| The city in which the airport is located e.g New York |
|
| 3-character airport IATA code e.g JFK |
|
| 4-character airport ICAO code e.g KJFK |
|
| The name of the airport e.g John F Kennedy International Airport |
|
| Diversion flight original flight number |
|
| Diversion flight original airline iata code |
|
| Diversion flight original airline icao code |
|
| Diversion flight original airline name |
|
| Diversion flight original scheduled date of operation |
|
| Flight Diversion recovery record |
|
| Airport |
|
| The city in which the airport is located e.g New York |
|
| The city in which the airport is located e.g New York |
|
| 3-character airport IATA code e.g JFK |
|
| 4-character airport ICAO code e.g KJFK |
|
| The name of the airport e.g John F Kennedy International Airport |
|
| Diversion flight recovery flight number |
|
| Diversion flight recovery airline iata code |
|
| Diversion flight recovery airline icao code |
|
| Diversion flight recovery airline name |
|
| Diversion flight recovery scheduled date of operation |
|
| The latest estimated local departure/arrival time for this flight e.g 2020-01-22T12:00:00+03:00 |
|
| Flight events. |
|
| The actual local time at which the aircraft arrived at the gate |
|
| The actual local time at which the aircraft landed on the runway |
|
| The actual local time at which the aircraft left the gate |
|
| The actual local time at which the aircraft left the runway |
|
| The estimated local time at which the aircraft is expected at the gate |
|
| The estimated local time at which the aircraft is expected to land on the runway |
|
| The estimated local time at which the aircraft is expected to leave the gate |
|
| The estimated local time at which the aircraft is expected to leave the runway |
|
| The local time at which the aircraft is targeted to leave the gate |
|
| The local time at which the aircraft is targeted to leave the runway |
|
| The flights departure/arrival gate e.g C1 |
|
| Arrival gate remark |
|
| Gate remark text when applicable e.g Boarding at 21:00 |
|
| Gate Slots |
|
| Location details of the slot resource i.e check-in desks1-20, Gate 2C etc |
|
| End time for the slot activity e.g check-in desk closed |
|
| Name used to identify the slot |
|
| Name used to identify the slot internally |
|
| Start time for the slot activity e.g check-in desk opened |
|
| Route |
|
| 3-character airport IATA code |
|
| 4-character airport ICAO code |
|
| Value used to identify the routes position within an entire flight route e.g leg 0, leg 1, leg 2 etc |
|
| The published scheduled local departure/arrival time for this flight e.g 2020-01-22T12:00:00+03:00 |
|
| Aircraft stand details e.g S12 |
|
| Stand Slots |
|
| Location details of the slot resource i.e check-in desks1-20, Gate 2C etc |
|
| End time for the slot activity e.g check-in desk closed |
|
| Name used to identify the slot |
|
| Name used to identify the slot internally |
|
| Start time for the slot activity e.g check-in desk opened |
|
| The current status code for this flight e.g SC, DP |
|
| The current status text for this flight e.g Scheduled, Departed |
|
| The flights departure/arrival terminal e.g T1 |
|
| Updates |
|
| Current field value |
|
| Previous field value |
|
| UTC timestamp when update was applied |
|
| Payload field which was updated |
|
| FLIFO internal version number |
|
| Departure |
|
| The actual local departure/arrival time for this flight e.g 2020-01-22T12:00:00+03:00 |
|
| Airport |
|
| The city in which the airport is located e.g New York |
|
| The city in which the airport is located e.g New York |
|
| 3-character airport IATA code e.g JFK |
|
| 4-character airport ICAO code e.g KJFK |
|
| The name of the airport e.g John F Kennedy International Airport |
|
| Expected carousel(s) for baggage reclaim |
|
| Carousel Slots |
|
| Location details of the slot resource i.e check-in desks1-20, Gate 2C etc |
|
| End time for the slot activity e.g check-in desk closed |
|
| Name used to identify the slot |
|
| Name used to identify the slot internally |
|
| Start time for the slot activity e.g check-in desk opened |
|
| Check-in desk details e.g CK-1 |
|
| Checkin Slots |
|
| Location details of the slot resource i.e check-in desks1-20, Gate 2C etc |
|
| End time for the slot activity e.g check-in desk closed |
|
| Name used to identify the slot |
|
| Name used to identify the slot internally |
|
| Start time for the slot activity e.g check-in desk opened |
|
| Baggage chute details e.g CH-2 |
|
| Chute Slots |
|
| Location details of the slot resource i.e check-in desks1-20, Gate 2C etc |
|
| End time for the slot activity e.g check-in desk closed |
|
| Name used to identify the slot |
|
| Name used to identify the slot internally |
|
| Start time for the slot activity e.g check-in desk opened |
|
| Custom Properties |
|
| Key value used to identify a custom property |
|
| The value of a custom property |
|
| Flight Diversion Details. |
|
| Flight Diversion original record |
|
| Airport |
|
| The city in which the airport is located e.g New York |
|
| The city in which the airport is located e.g New York |
|
| 3-character airport IATA code e.g JFK |
|
| 4-character airport ICAO code e.g KJFK |
|
| The name of the airport e.g John F Kennedy International Airport |
|
| Diversion flight original flight number |
|
| Diversion flight original airline iata code |
|
| Diversion flight original airline icao code |
|
| Diversion flight original airline name |
|
| Diversion flight original scheduled date of operation |
|
| Flight Diversion recovery record |
|
| Airport |
|
| The city in which the airport is located e.g New York |
|
| The city in which the airport is located e.g New York |
|
| 3-character airport IATA code e.g JFK |
|
| 4-character airport ICAO code e.g KJFK |
|
| The name of the airport e.g John F Kennedy International Airport |
|
| Diversion flight recovery flight number |
|
| Diversion flight recovery airline iata code |
|
| Diversion flight recovery airline icao code |
|
| Diversion flight recovery airline name |
|
| Diversion flight recovery scheduled date of operation |
|
| The latest estimated local departure/arrival time for this flight e.g 2020-01-22T12:00:00+03:00 |
|
| Flight events. |
|
| The actual local time at which the aircraft arrived at the gate |
|
| The actual local time at which the aircraft landed on the runway |
|
| The actual local time at which the aircraft left the gate |
|
| The actual local time at which the aircraft left the runway |
|
| The estimated local time at which the aircraft is expected at the gate |
|
| The estimated local time at which the aircraft is expected to land on the runway |
|
| The estimated local time at which the aircraft is expected to leave the gate |
|
| The estimated local time at which the aircraft is expected to leave the runway |
|
| The local time at which the aircraft is targeted to leave the gate |
|
| The local time at which the aircraft is targeted to leave the runway |
|
| The flights departure/arrival gate e.g C1 |
|
| Departure gate remark |
|
| Gate remark text when applicable e.g Boarding at 21:00 |
|
| Gate Slots |
|
| Location details of the slot resource i.e check-in desks1-20, Gate 2C etc |
|
| End time for the slot activity e.g check-in desk closed |
|
| Name used to identify the slot |
|
| Name used to identify the slot internally |
|
| Start time for the slot activity e.g check-in desk opened |
|
| Route |
|
| 3-character airport IATA code |
|
| 4-character airport ICAO code |
|
| Value used to identify the routes position within an entire flight route e.g leg 0, leg 1, leg 2 etc |
|
| The published scheduled local departure/arrival time for this flight e.g 2020-01-22T12:00:00+03:00 |
|
| Aircraft stand details e.g S12 |
|
| Stand Slots |
|
| Location details of the slot resource i.e check-in desks1-20, Gate 2C etc |
|
| End time for the slot activity e.g check-in desk closed |
|
| Name used to identify the slot |
|
| Name used to identify the slot internally |
|
| Start time for the slot activity e.g check-in desk opened |
|
| The current status code for this flight e.g SC, DP |
|
| The current status text for this flight e.g Scheduled, Departed |
|
| The flights departure/arrival terminal e.g T1 |
|
| Updates |
|
| Current field value |
|
| Previous field value |
|
| UTC timestamp when update was applied |
|
| Payload field which was updated |
|
| FLIFO internal version number |
|
| Flight duration in minutes e.g 60 |
|
| Flight Identifier |
|
| Aircraft |
|
| Callsign for the aircraft type |
|
| IATA code for the aircraft |
|
| ICAO code for the aircraft |
|
| Specific aircraft model details |
|
| Aircraft regristration/tail number details e.g EIAA44W |
|
| A value that uniquely identifies a flight within the system |
|
| Marketing Carriers |
|
| Flight number e.g 1234 |
|
| 2-character airline IATA code e.g AA |
|
| 3-character airline ICAO code e.g AAL |
|
| Name of airline e.g American Airlines |
|
| Operating Carrier |
|
| Flight number e.g 1234 |
|
| 2-character airline IATA code e.g AA |
|
| 3-character airline ICAO code e.g AAL |
|
| Name of airline e.g American Airlines |
|
| Flight Stats |
|
| Baggage |
|
| Total number of cargo pieces |
|
| Total number of bags/pieces |
|
| Load breakdown |
|
| Total number of mail pieces |
|
| Total weight of bags/pieces |
|
| Passengers |
|
| Actual number of business class passengers |
|
| Actual number of economy class passengers |
|
| Actual number of 1st class passengers |
|
| Actual number of passengers |
|
| Actual number of transfer passengers |
|
| Actual number of transit passengers |
|
| Total number of adults |
|
| Total number of booked business class passengers |
|
| Total number of booked economy class passengers |
|
| Total number of booked 1st class passengers |
|
| Total number of booked passengers |
|
| Total number of children |
|
| Total number of infants |
|
| Total number of reduced mobility passengers e.g those requiring assistance boarding the aircraft etc. |
|
| UTC timestamp when last update update was applied to this flight |
|
| Data source of the last update applied to this flight |
|
| Flight service type e.g J-Passenger, F-Cargo |
Curl request
$ curl 'https://flifo.api.aero/flifo/flightinfo/v2/flights/airport/AMS/direction/A?operationDate=2020-01-22T12:00:00' -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: 16266
{
"flightRecords" : [ {
"flightIdentifier" : {
"operatingCarrier" : {
"iataCode" : "KL",
"flightNumber" : "1146",
"name" : "KLM Royal Dutch Airlines"
},
"marketingCarriers" : [ {
"iataCode" : "DL",
"flightNumber" : "9598",
"name" : "Delta Air Lines"
} ],
"aircraft" : {
"iataCode" : "EMJ",
"registration" : "PHEZH"
},
"flightId" : "12345678"
},
"flightStats" : {
"passengers" : {
"bookedTotal" : "100",
"bookedFirst" : "4",
"bookedBusiness" : "16",
"bookedEconomy" : "106",
"actualTotal" : "100",
"actualFirst" : "4",
"actualBusiness" : "16",
"actualEconomy" : "4",
"actualTransfer" : "100",
"actualTransit" : "100",
"reducedMobility" : "0",
"adult" : "60",
"child" : "15",
"infant" : "5"
},
"baggage" : {
"count" : "50",
"load" : "50000",
"totalWeight" : "500",
"cargo" : "20",
"mail" : "30"
}
},
"departure" : {
"airport" : {
"iataCode" : "OSL",
"cityText" : "Oslo"
},
"scheduled" : "2020-01-22T12:00:00+01:00",
"status" : "SC",
"statusText" : "Scheduled",
"terminal" : "2",
"gate" : "10E",
"carousel" : "10E",
"stand" : "440E",
"checkIn" : "10E",
"chute" : "10E",
"standSlots" : [ {
"name" : "4O",
"externalName" : "4OE",
"startTime" : "2020-01-22T06:00:00+01:00",
"endTime" : "2020-01-22T08:00:00+01:00",
"area" : "A"
} ],
"checkinSlots" : [ {
"name" : "1O",
"externalName" : "1OE",
"startTime" : "2020-01-22T06:00:00+01:00",
"endTime" : "2020-01-22T08:00:00+01:00"
} ],
"carouselSlots" : [ {
"name" : "1O",
"externalName" : "1OE",
"startTime" : "2020-01-22T06:00:00+01:00",
"endTime" : "2020-01-22T08:00:00+01:00"
} ],
"gateSlots" : [ {
"name" : "10",
"externalName" : "10E",
"startTime" : "2020-01-22T06:00:00+01:00",
"endTime" : "2020-01-22T08:00:00+01:00"
} ],
"chuteSlots" : [ {
"name" : "10",
"externalName" : "10E",
"startTime" : "2020-01-22T06:00:00+01:00",
"endTime" : "2020-01-22T08:00:00+01:00"
} ],
"route" : [ {
"iataCode" : "DUB",
"icaoCode" : "EIDW",
"sequenceNumber" : "0"
} ],
"customProperties" : [ {
"key" : "mycustomkey",
"value" : "newcustomvalue"
} ],
"events" : {
"ALDT" : "2020-01-22T12:15:00+01:00",
"AIBT" : "2020-01-22T12:15:00+01:00",
"AOBT" : "2020-01-22T12:15:00+01:00",
"ATOT" : "2020-01-22T12:15:00+01:00",
"ELDT" : "2020-01-22T12:15:00+01:00",
"EIBT" : "2020-01-22T12:15:00+01:00",
"EOBT" : "2020-01-22T12:15:00+01:00",
"ETOT" : "2020-01-22T12:15:00+01:00",
"TOBT" : "2020-01-22T12:15:00+01:00",
"TTOT" : "2020-01-22T12:15:00+01:00"
}
},
"arrival" : {
"airport" : {
"iataCode" : "AMS",
"cityText" : "Amsterdam"
},
"scheduled" : "2020-01-22T16:00:00+01:00",
"estimated" : "2020-01-22T16:03:00+01:00",
"actual" : "2020-01-22T16:03:00+01:00",
"status" : "AR",
"statusText" : "Arrived",
"terminal" : "2",
"gate" : "A4",
"carousel" : "10E",
"stand" : "40E",
"checkIn" : "10E",
"chute" : "10E",
"standSlots" : [ {
"name" : "4O",
"externalName" : "4OE",
"startTime" : "2020-01-22T06:00:00+01:00",
"endTime" : "2020-01-22T08:00:00+01:00",
"area" : "A"
} ],
"checkinSlots" : [ {
"name" : "1O",
"externalName" : "1OE",
"startTime" : "2020-01-22T06:00:00+01:00",
"endTime" : "2020-01-22T08:00:00+01:00"
} ],
"carouselSlots" : [ {
"name" : "1O",
"externalName" : "1OE",
"startTime" : "2020-01-22T06:00:00+01:00",
"endTime" : "2020-01-22T08:00:00+01:00"
} ],
"gateSlots" : [ {
"name" : "A",
"externalName" : "A4",
"startTime" : "2020-01-22T06:00:00+01:00",
"endTime" : "2020-01-22T08:00:00+01:00"
} ],
"chuteSlots" : [ {
"name" : "10",
"externalName" : "10E",
"startTime" : "2020-01-22T06:00:00+01:00",
"endTime" : "2020-01-22T08:00:00+01:00"
} ],
"route" : [ {
"iataCode" : "DUB",
"icaoCode" : "EIDW",
"sequenceNumber" : "0"
} ],
"customProperties" : [ {
"key" : "mycustomkey",
"value" : "newcustomvalue"
} ],
"events" : {
"ALDT" : "2020-01-22T16:01:00+01:00",
"AIBT" : "2020-01-22T16:01:00+01:00",
"AOBT" : "2020-01-22T16:01:00+01:00",
"ATOT" : "2020-01-22T16:01:00+01:00",
"ELDT" : "2020-01-22T16:01:00+01:00",
"EIBT" : "2020-01-22T16:01:00+01:00",
"EOBT" : "2020-01-22T16:01:00+01:00",
"ETOT" : "2020-01-22T16:01:00+01:00",
"TOBT" : "2020-01-22T16:01:00+01:00",
"TTOT" : "2020-01-22T16:01:00+01:00"
}
},
"serviceType" : "J",
"duration" : "240"
}, {
"flightIdentifier" : {
"operatingCarrier" : {
"iataCode" : "KL",
"flightNumber" : "1394",
"name" : "KLM Royal Dutch Airlines"
},
"aircraft" : {
"iataCode" : "73H",
"registration" : "PHBXG"
},
"flightId" : "12345678"
},
"flightStats" : {
"passengers" : {
"bookedTotal" : "100",
"bookedFirst" : "4",
"bookedBusiness" : "16",
"bookedEconomy" : "106",
"actualTotal" : "100",
"actualFirst" : "4",
"actualBusiness" : "16",
"actualEconomy" : "4",
"actualTransfer" : "100",
"actualTransit" : "100",
"reducedMobility" : "0",
"adult" : "60",
"child" : "15",
"infant" : "5"
},
"baggage" : {
"count" : "50",
"load" : "50000",
"totalWeight" : "500",
"cargo" : "20",
"mail" : "30"
}
},
"departure" : {
"airport" : {
"iataCode" : "LED",
"cityText" : "St. Petersburg"
},
"scheduled" : "2020-01-22T12:00:00+03:00",
"status" : "SC",
"statusText" : "Scheduled",
"terminal" : "3",
"gate" : "10E",
"carousel" : "10E",
"stand" : "440E",
"checkIn" : "10E",
"chute" : "10E",
"standSlots" : [ {
"name" : "4O",
"externalName" : "4OE",
"startTime" : "2020-01-22T06:00:00+03:00",
"endTime" : "2020-01-22T08:00:00+03:00",
"area" : "A"
} ],
"checkinSlots" : [ {
"name" : "1O",
"externalName" : "1OE",
"startTime" : "2020-01-22T06:00:00+03:00",
"endTime" : "2020-01-22T08:00:00+03:00"
} ],
"carouselSlots" : [ {
"name" : "1O",
"externalName" : "1OE",
"startTime" : "2020-01-22T06:00:00+03:00",
"endTime" : "2020-01-22T08:00:00+03:00"
} ],
"gateSlots" : [ {
"name" : "10",
"externalName" : "10E",
"startTime" : "2020-01-22T06:00:00+03:00",
"endTime" : "2020-01-22T08:00:00+03:00"
} ],
"chuteSlots" : [ {
"name" : "10",
"externalName" : "10E",
"startTime" : "2020-01-22T06:00:00+03:00",
"endTime" : "2020-01-22T08:00:00+03:00"
} ],
"route" : [ {
"iataCode" : "DUB",
"icaoCode" : "EIDW",
"sequenceNumber" : "0"
} ],
"customProperties" : [ {
"key" : "mycustomkey",
"value" : "newcustomvalue"
} ],
"events" : {
"ALDT" : "2020-01-22T12:15:00+03:00",
"AIBT" : "2020-01-22T12:15:00+03:00",
"AOBT" : "2020-01-22T12:15:00+03:00",
"ATOT" : "2020-01-22T12:15:00+03:00",
"ELDT" : "2020-01-22T12:15:00+03:00",
"EIBT" : "2020-01-22T12:15:00+03:00",
"EOBT" : "2020-01-22T12:15:00+03:00",
"ETOT" : "2020-01-22T12:15:00+03:00",
"TOBT" : "2020-01-22T12:15:00+03:00",
"TTOT" : "2020-01-22T12:15:00+03:00"
}
},
"arrival" : {
"airport" : {
"iataCode" : "AMS",
"cityText" : "Amsterdam"
},
"scheduled" : "2020-01-22T16:00:00+01:00",
"estimated" : "2020-01-22T15:47:00+01:00",
"actual" : "2020-01-22T15:47:00+01:00",
"status" : "AR",
"statusText" : "Arrived",
"terminal" : "3",
"gate" : "10E",
"carousel" : "10E",
"stand" : "440E",
"checkIn" : "10E",
"chute" : "10E",
"standSlots" : [ {
"name" : "4O",
"externalName" : "4OE",
"startTime" : "2020-01-22T06:00:00+01:00",
"endTime" : "2020-01-22T08:00:00+01:00",
"area" : "A"
} ],
"checkinSlots" : [ {
"name" : "1O",
"externalName" : "1OE",
"startTime" : "2020-01-22T06:00:00+01:00",
"endTime" : "2020-01-22T08:00:00+01:00"
} ],
"carouselSlots" : [ {
"name" : "1O",
"externalName" : "1OE",
"startTime" : "2020-01-22T06:00:00+01:00",
"endTime" : "2020-01-22T08:00:00+01:00"
} ],
"gateSlots" : [ {
"name" : "10",
"externalName" : "10E",
"startTime" : "2020-01-22T06:00:00+01:00",
"endTime" : "2020-01-22T08:00:00+01:00"
} ],
"chuteSlots" : [ {
"name" : "10",
"externalName" : "10E",
"startTime" : "2020-01-22T06:00:00+01:00",
"endTime" : "2020-01-22T08:00:00+01:00"
} ],
"route" : [ {
"iataCode" : "DUB",
"icaoCode" : "EIDW",
"sequenceNumber" : "0"
} ],
"customProperties" : [ {
"key" : "mycustomkey",
"value" : "newcustomvalue"
} ],
"events" : {
"ALDT" : "2020-01-22T12:15:00+01:00",
"AIBT" : "2020-01-22T12:15:00+01:00",
"AOBT" : "2020-01-22T12:15:00+01:00",
"ATOT" : "2020-01-22T12:15:00+01:00",
"ELDT" : "2020-01-22T12:15:00+01:00",
"EIBT" : "2020-01-22T12:15:00+01:00",
"EOBT" : "2020-01-22T12:15:00+01:00",
"ETOT" : "2020-01-22T12:15:00+01:00",
"TOBT" : "2020-01-22T12:15:00+01:00",
"TTOT" : "2020-01-22T12:15:00+01:00"
}
},
"serviceType" : "J",
"duration" : "360"
}, {
"flightIdentifier" : {
"operatingCarrier" : {
"iataCode" : "KL",
"flightNumber" : "1386",
"name" : "KLM Royal Dutch Airlines"
},
"aircraft" : {
"iataCode" : "73H",
"registration" : "PHHSE"
},
"flightId" : "12345678"
},
"flightStats" : {
"passengers" : {
"bookedTotal" : "100",
"bookedFirst" : "4",
"bookedBusiness" : "16",
"bookedEconomy" : "106",
"actualTotal" : "100",
"actualFirst" : "4",
"actualBusiness" : "16",
"actualEconomy" : "4",
"actualTransfer" : "100",
"actualTransit" : "100",
"reducedMobility" : "0",
"adult" : "60",
"child" : "15",
"infant" : "5"
},
"baggage" : {
"count" : "50",
"load" : "50000",
"totalWeight" : "500",
"cargo" : "20",
"mail" : "30"
}
},
"departure" : {
"airport" : {
"iataCode" : "KBP",
"cityText" : "Kiev"
},
"scheduled" : "2020-01-22T12:00:00+02:00",
"status" : "SC",
"statusText" : "Scheduled",
"terminal" : "3",
"gate" : "10E",
"carousel" : "10E",
"stand" : "440E",
"checkIn" : "10E",
"chute" : "10E",
"standSlots" : [ {
"name" : "4O",
"externalName" : "4OE",
"startTime" : "2020-01-22T06:00:00+02:00",
"endTime" : "2020-01-22T08:00:00+02:00",
"area" : "A"
} ],
"checkinSlots" : [ {
"name" : "1O",
"externalName" : "1OE",
"startTime" : "2020-01-22T06:00:00+02:00",
"endTime" : "2020-01-22T08:00:00+02:00"
} ],
"carouselSlots" : [ {
"name" : "1O",
"externalName" : "1OE",
"startTime" : "2020-01-22T06:00:00+02:00",
"endTime" : "2020-01-22T08:00:00+02:00"
} ],
"gateSlots" : [ {
"name" : "10",
"externalName" : "10E",
"startTime" : "2020-01-22T06:00:00+02:00",
"endTime" : "2020-01-22T08:00:00+02:00"
} ],
"chuteSlots" : [ {
"name" : "10",
"externalName" : "10E",
"startTime" : "2020-01-22T06:00:00+02:00",
"endTime" : "2020-01-22T08:00:00+02:00"
} ],
"route" : [ {
"iataCode" : "DUB",
"icaoCode" : "EIDW",
"sequenceNumber" : "0"
} ],
"customProperties" : [ {
"key" : "mycustomkey",
"value" : "newcustomvalue"
} ],
"events" : {
"ALDT" : "2020-01-22T12:15:00+02:00",
"AIBT" : "2020-01-22T12:15:00+02:00",
"AOBT" : "2020-01-22T12:15:00+02:00",
"ATOT" : "2020-01-22T12:15:00+02:00",
"ELDT" : "2020-01-22T12:15:00+02:00",
"EIBT" : "2020-01-22T12:15:00+02:00",
"EOBT" : "2020-01-22T12:15:00+02:00",
"ETOT" : "2020-01-22T12:15:00+02:00",
"TOBT" : "2020-01-22T12:15:00+02:00",
"TTOT" : "2020-01-22T12:15:00+02:00"
}
},
"arrival" : {
"airport" : {
"iataCode" : "AMS",
"cityText" : "Amsterdam"
},
"scheduled" : "2020-01-22T16:00:00+01:00",
"estimated" : "2020-01-22T15:44:00+01:00",
"actual" : "2020-01-22T15:44:00+01:00",
"status" : "AR",
"statusText" : "Arrived",
"terminal" : "3",
"gate" : "10E",
"carousel" : "10E",
"stand" : "440E",
"checkIn" : "10E",
"chute" : "10E",
"standSlots" : [ {
"name" : "4O",
"externalName" : "4OE",
"startTime" : "2020-01-22T06:00:00+01:00",
"endTime" : "2020-01-22T08:00:00+01:00",
"area" : "A"
} ],
"checkinSlots" : [ {
"name" : "1O",
"externalName" : "1OE",
"startTime" : "2020-01-22T06:00:00+01:00",
"endTime" : "2020-01-22T08:00:00+01:00"
} ],
"carouselSlots" : [ {
"name" : "1O",
"externalName" : "1OE",
"startTime" : "2020-01-22T06:00:00+01:00",
"endTime" : "2020-01-22T08:00:00+01:00"
} ],
"gateSlots" : [ {
"name" : "10",
"externalName" : "10E",
"startTime" : "2020-01-22T06:00:00+01:00",
"endTime" : "2020-01-22T08:00:00+01:00"
} ],
"chuteSlots" : [ {
"name" : "10",
"externalName" : "10E",
"startTime" : "2020-01-22T06:00:00+01:00",
"endTime" : "2020-01-22T08:00:00+01:00"
} ],
"route" : [ {
"iataCode" : "DUB",
"icaoCode" : "EIDW",
"sequenceNumber" : "0"
} ],
"customProperties" : [ {
"key" : "mycustomkey",
"value" : "newcustomvalue"
} ],
"events" : {
"ALDT" : "2020-01-22T12:15:00+01:00",
"AIBT" : "2020-01-22T12:15:00+01:00",
"AOBT" : "2020-01-22T12:15:00+01:00",
"ATOT" : "2020-01-22T12:15:00+01:00",
"ELDT" : "2020-01-22T12:15:00+01:00",
"EIBT" : "2020-01-22T12:15:00+01:00",
"EOBT" : "2020-01-22T12:15:00+01:00",
"ETOT" : "2020-01-22T12:15:00+01:00",
"TOBT" : "2020-01-22T12:15:00+01:00",
"TTOT" : "2020-01-22T12:15:00+01:00"
}
},
"serviceType" : "J",
"duration" : "300"
} ]
}
2.2.1.4 GET Get Flight Updates by Airport, Airline and Flight Number
Retrieve a single flight and its updates based on airline, flight number and arrival/departure airport. Results are filtered by operation date (default is current UTC date).
Payload elements are filtered based on permissions associated with the 'x-apikey' used in the request.
operationDate
In this scenario the operationDate is considered to be the local date on which the flight departed/arrived.
operationDate & searchByUTC
A user can force the operationDate value to be considered as UTC by providing the parameter 'searchByUTC=true'.
Path parameters
Parameter | Description |
---|---|
| 3-character airport IATA code or 4-character airport ICAO code |
| 2-character airline IATA code or 3-character airline ICAO code |
| Flight number |
Query parameters
Parameter | Description |
---|---|
| Local date of operation (yyyy-MM-dd). Default value is current UTC date |
| Date interval start e.g 2020-01-01T12:00:00-0000. Default is current UTC date/time - 2 minutes |
| Date interval end e.g 2020-01-01T12:05:00-0000. Default is current UTC date/time - 1 minutes |
| Show updated fields |
| Group marketing and operating carrier flights into a single record. Default value is false |
| Group updates in a single record |
| Show additional information such as version |
| Include cargo flights. Default value is false |
Request headers
Name | Optional | Description |
---|---|---|
Content-Type | false | Content type of this request. Required value is 'application/json' |
Authorization | false | Authorization header that contains the access token. |
Response fields
Path | Type | Description |
---|---|---|
|
| Flight Records |
|
| Arrival |
|
| The actual local departure/arrival time for this flight e.g 2020-01-22T12:00:00+03:00 |
|
| Airport |
|
| The city in which the airport is located e.g New York |
|
| The city in which the airport is located e.g New York |
|
| 3-character airport IATA code e.g JFK |
|
| 4-character airport ICAO code e.g KJFK |
|
| The name of the airport e.g John F Kennedy International Airport |
|
| Expected carousel(s) for baggage reclaim |
|
| Carousel Slots |
|
| Location details of the slot resource i.e check-in desks1-20, Gate 2C etc |
|
| End time for the slot activity e.g check-in desk closed |
|
| Name used to identify the slot |
|
| Name used to identify the slot internally |
|
| Start time for the slot activity e.g check-in desk opened |
|
| Check-in desk details e.g CK-1 |
|
| Checkin Slots |
|
| Location details of the slot resource i.e check-in desks1-20, Gate 2C etc |
|
| End time for the slot activity e.g check-in desk closed |
|
| Name used to identify the slot |
|
| Name used to identify the slot internally |
|
| Start time for the slot activity e.g check-in desk opened |
|
| Baggage chute details e.g CH-2 |
|
| Chute Slots |
|
| Location details of the slot resource i.e check-in desks1-20, Gate 2C etc |
|
| End time for the slot activity e.g check-in desk closed |
|
| Name used to identify the slot |
|
| Name used to identify the slot internally |
|
| Start time for the slot activity e.g check-in desk opened |
|
| Custom Properties |
|
| Key value used to identify a custom property |
|
| The value of a custom property |
|
| Flight Diversion Details. |
|
| Flight Diversion original record |
|
| Airport |
|
| The city in which the airport is located e.g New York |
|
| The city in which the airport is located e.g New York |
|
| 3-character airport IATA code e.g JFK |
|
| 4-character airport ICAO code e.g KJFK |
|
| The name of the airport e.g John F Kennedy International Airport |
|
| Diversion flight original flight number |
|
| Diversion flight original airline iata code |
|
| Diversion flight original airline icao code |
|
| Diversion flight original airline name |
|
| Diversion flight original scheduled date of operation |
|
| Flight Diversion recovery record |
|
| Airport |
|
| The city in which the airport is located e.g New York |
|
| The city in which the airport is located e.g New York |
|
| 3-character airport IATA code e.g JFK |
|
| 4-character airport ICAO code e.g KJFK |
|
| The name of the airport e.g John F Kennedy International Airport |
|
| Diversion flight recovery flight number |
|
| Diversion flight recovery airline iata code |
|
| Diversion flight recovery airline icao code |
|
| Diversion flight recovery airline name |
|
| Diversion flight recovery scheduled date of operation |
|
| The latest estimated local departure/arrival time for this flight e.g 2020-01-22T12:00:00+03:00 |
|
| Flight events. |
|
| The actual local time at which the aircraft arrived at the gate |
|
| The actual local time at which the aircraft landed on the runway |
|
| The actual local time at which the aircraft left the gate |
|
| The actual local time at which the aircraft left the runway |
|
| The estimated local time at which the aircraft is expected at the gate |
|
| The estimated local time at which the aircraft is expected to land on the runway |
|
| The estimated local time at which the aircraft is expected to leave the gate |
|
| The estimated local time at which the aircraft is expected to leave the runway |
|
| The local time at which the aircraft is targeted to leave the gate |
|
| The local time at which the aircraft is targeted to leave the runway |
|
| The flights departure/arrival gate e.g C1 |
|
| Arrival gate remark |
|
| Gate remark text when applicable e.g Boarding at 21:00 |
|
| Gate Slots |
|
| Location details of the slot resource i.e check-in desks1-20, Gate 2C etc |
|
| End time for the slot activity e.g check-in desk closed |
|
| Name used to identify the slot |
|
| Name used to identify the slot internally |
|
| Start time for the slot activity e.g check-in desk opened |
|
| Route |
|
| 3-character airport IATA code |
|
| 4-character airport ICAO code |
|
| Value used to identify the routes position within an entire flight route e.g leg 0, leg 1, leg 2 etc |
|
| The published scheduled local departure/arrival time for this flight e.g 2020-01-22T12:00:00+03:00 |
|
| Aircraft stand details e.g S12 |
|
| Stand Slots |
|
| Location details of the slot resource i.e check-in desks1-20, Gate 2C etc |
|
| End time for the slot activity e.g check-in desk closed |
|
| Name used to identify the slot |
|
| Name used to identify the slot internally |
|
| Start time for the slot activity e.g check-in desk opened |
|
| The current status code for this flight e.g SC, DP |
|
| The current status text for this flight e.g Scheduled, Departed |
|
| The flights departure/arrival terminal e.g T1 |
|
| Updates |
|
| Current field value |
|
| UTC timestamp when update was applied (only visible when updates are grouped) |
|
| Data source of this update (only visible when updates are grouped) |
|
| Previous field value |
|
| UTC timestamp when update was received |
|
| Payload field which was updated |
|
| FLIFO internal version number |
|
| Departure |
|
| The actual local departure/arrival time for this flight e.g 2020-01-22T12:00:00+03:00 |
|
| Airport |
|
| The city in which the airport is located e.g New York |
|
| The city in which the airport is located e.g New York |
|
| 3-character airport IATA code e.g JFK |
|
| 4-character airport ICAO code e.g KJFK |
|
| The name of the airport e.g John F Kennedy International Airport |
|
| Expected carousel(s) for baggage reclaim |
|
| Carousel Slots |
|
| Location details of the slot resource i.e check-in desks1-20, Gate 2C etc |
|
| End time for the slot activity e.g check-in desk closed |
|
| Name used to identify the slot |
|
| Name used to identify the slot internally |
|
| Start time for the slot activity e.g check-in desk opened |
|
| Check-in desk details e.g CK-1 |
|
| Checkin Slots |
|
| Location details of the slot resource i.e check-in desks1-20, Gate 2C etc |
|
| End time for the slot activity e.g check-in desk closed |
|
| Name used to identify the slot |
|
| Name used to identify the slot internally |
|
| Start time for the slot activity e.g check-in desk opened |
|
| Baggage chute details e.g CH-2 |
|
| Chute Slots |
|
| Location details of the slot resource i.e check-in desks1-20, Gate 2C etc |
|
| End time for the slot activity e.g check-in desk closed |
|
| Name used to identify the slot |
|
| Name used to identify the slot internally |
|
| Start time for the slot activity e.g check-in desk opened |
|
| Custom Properties |
|
| Key value used to identify a custom property |
|
| The value of a custom property |
|
| Flight Diversion Details. |
|
| Flight Diversion original record |
|
| Airport |
|
| The city in which the airport is located e.g New York |
|
| The city in which the airport is located e.g New York |
|
| 3-character airport IATA code e.g JFK |
|
| 4-character airport ICAO code e.g KJFK |
|
| The name of the airport e.g John F Kennedy International Airport |
|
| Diversion flight original flight number |
|
| Diversion flight original airline iata code |
|
| Diversion flight original airline icao code |
|
| Diversion flight original airline name |
|
| Diversion flight original scheduled date of operation |
|
| Flight Diversion recovery record |
|
| Airport |
|
| The city in which the airport is located e.g New York |
|
| The city in which the airport is located e.g New York |
|
| 3-character airport IATA code e.g JFK |
|
| 4-character airport ICAO code e.g KJFK |
|
| The name of the airport e.g John F Kennedy International Airport |
|
| Diversion flight recovery flight number |
|
| Diversion flight recovery airline iata code |
|
| Diversion flight recovery airline icao code |
|
| Diversion flight recovery airline name |
|
| Diversion flight recovery scheduled date of operation |
|
| The latest estimated local departure/arrival time for this flight e.g 2020-01-22T12:00:00+03:00 |
|
| Flight events. |
|
| The actual local time at which the aircraft arrived at the gate |
|
| The actual local time at which the aircraft landed on the runway |
|
| The actual local time at which the aircraft left the gate |
|
| The actual local time at which the aircraft left the runway |
|
| The estimated local time at which the aircraft is expected at the gate |
|
| The estimated local time at which the aircraft is expected to land on the runway |
|
| The estimated local time at which the aircraft is expected to leave the gate |
|
| The estimated local time at which the aircraft is expected to leave the runway |
|
| The local time at which the aircraft is targeted to leave the gate |
|
| The local time at which the aircraft is targeted to leave the runway |
|
| The flights departure/arrival gate e.g C1 |
|
| Departure gate remark |
|
| Gate remark text when applicable e.g Boarding at 21:00 |
|
| Gate Slots |
|
| Location details of the slot resource i.e check-in desks1-20, Gate 2C etc |
|
| End time for the slot activity e.g check-in desk closed |
|
| Name used to identify the slot |
|
| Name used to identify the slot internally |
|
| Start time for the slot activity e.g check-in desk opened |
|
| Route |
|
| 3-character airport IATA code |
|
| 4-character airport ICAO code |
|
| Value used to identify the routes position within an entire flight route e.g leg 0, leg 1, leg 2 etc |
|
| The published scheduled local departure/arrival time for this flight e.g 2020-01-22T12:00:00+03:00 |
|
| Aircraft stand details e.g S12 |
|
| Stand Slots |
|
| Location details of the slot resource i.e check-in desks1-20, Gate 2C etc |
|
| End time for the slot activity e.g check-in desk closed |
|
| Name used to identify the slot |
|
| Name used to identify the slot internally |
|
| Start time for the slot activity e.g check-in desk opened |
|
| The current status code for this flight e.g SC, DP |
|
| The current status text for this flight e.g Scheduled, Departed |
|
| The flights departure/arrival terminal e.g T1 |
|
| Updates |
|
| Current field value |
|
| UTC timestamp when update was applied (only visible when updates are grouped) |
|
| Data source of this update (only visible when updates are grouped) |
|
| Previous field value |
|
| UTC timestamp when update was received |
|
| Payload field which was updated |
|
| FLIFO internal version number |
|
| Flight duration in minutes e.g 60 |
|
| Flight Identifier |
|
| Aircraft |
|
| Callsign for the aircraft type |
|
| IATA code for the aircraft |
|
| ICAO code for the aircraft |
|
| Specific aircraft model details |
|
| Aircraft regristration/tail number details e.g EIAA44W |
|
| A value that uniquely identifies a flight within the system |
|
| Marketing Carriers |
|
| Flight number e.g 1234 |
|
| 2-character airline IATA code e.g AA |
|
| 3-character airline ICAO code e.g AAL |
|
| Name of airline e.g American Airlines |
|
| Operating Carrier |
|
| Flight number e.g 1234 |
|
| 2-character airline IATA code e.g A |
|
| 3-character airline ICAO code e.g AAL |
|
| Name of airline e.g American Airlines |
|
| Flight Stats |
|
| Baggage |
|
| Total number of cargo pieces |
|
| Total number of bags/pieces |
|
| Load breakdown |
|
| Total number of mail pieces |
|
| Total weight of bags/pieces |
|
| Passengers |
|
| Actual number of business class passengers |
|
| Actual number of economy class passengers |
|
| Actual number of 1st class passengers |
|
| Actual number of passengers |
|
| Actual number of transfer passengers |
|
| Actual number of transit passengers |
|
| Total number of adults |
|
| Total number of booked business class passengers |
|
| Total number of booked economy class passengers |
|
| Total number of booked 1st class passengers |
|
| Total number of booked passengers |
|
| Total number of children |
|
| Total number of infants |
|
| Total number of reduced mobility passengers e.g those requiring assistance boarding the aircraft etc. |
|
| UTC timestamp when update was applied |
|
| Data source of this update |
|
| Flight service type e.g J-Passenger, F-Cargo |
|
| Group Marketing Carriers |
|
| Group Updates |
|
| Include Updates |
|
| Interval |
|
| From |
|
| Serial Version UID |
|
| To |
|
| Serial Version UID |
|
| Matched Records |
|
| Session Id |
|
| $ assertions Disabled |
|
| Least Sig Bits |
|
| Most Sig Bits |
|
| Serial Version UID |
Curl request
$ curl 'https://flifo.api.aero/flifo/flightinfo/v2/flights/updates/airport/AMS/airline/KL/flightNumber/1394?from=2020-01-22T12:00:00.000Z&to=2020-01-22T13:00:00.000Z' -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: 5376
{
"sessionId" : "26dfaad0-034a-4292-a76d-1f57ff9473b0",
"interval" : {
"from" : "2020-01-22T10:00:00+00:00",
"to" : "2020-01-22T11:00:00+00:00"
},
"includeUpdates" : false,
"groupUpdates" : false,
"groupMarketingCarriers" : false,
"matchedRecords" : 5,
"flightRecords" : [ {
"flightIdentifier" : {
"operatingCarrier" : {
"iataCode" : "KL",
"flightNumber" : "1394",
"name" : "KLM Royal Dutch Airlines"
},
"aircraft" : {
"iataCode" : "73H",
"registration" : "PHBXG"
}
},
"departure" : {
"airport" : {
"iataCode" : "LED",
"cityText" : "St. Petersburg"
},
"scheduled" : "2020-01-22T12:00:00+03:00",
"status" : "SC",
"statusText" : "Scheduled",
"terminal" : "3"
},
"arrival" : {
"airport" : {
"iataCode" : "AMS",
"cityText" : "Amsterdam"
},
"scheduled" : "2020-01-22T16:00:00+01:00",
"status" : "SC",
"statusText" : "Scheduled",
"terminal" : "3",
"gate" : "A9",
"carousel" : "15",
"gateSlots" : [ {
"externalName" : "A9"
} ]
},
"serviceType" : "J",
"duration" : "360"
}, {
"flightIdentifier" : {
"operatingCarrier" : {
"iataCode" : "KL",
"flightNumber" : "1394",
"name" : "KLM Royal Dutch Airlines"
},
"aircraft" : {
"iataCode" : "73H",
"registration" : "PHBXG"
}
},
"departure" : {
"airport" : {
"iataCode" : "LED",
"cityText" : "St. Petersburg"
},
"scheduled" : "2020-01-22T12:00:00+03:00",
"status" : "SC",
"statusText" : "Scheduled",
"terminal" : "3"
},
"arrival" : {
"airport" : {
"iataCode" : "AMS",
"cityText" : "Amsterdam"
},
"scheduled" : "2020-01-22T16:00:00+01:00",
"status" : "AR",
"statusText" : "Arrived",
"terminal" : "3",
"gate" : "A9",
"carousel" : "15",
"gateSlots" : [ {
"externalName" : "A9"
} ]
},
"serviceType" : "J",
"duration" : "360"
}, {
"flightIdentifier" : {
"operatingCarrier" : {
"iataCode" : "KL",
"flightNumber" : "1394",
"name" : "KLM Royal Dutch Airlines"
},
"aircraft" : {
"iataCode" : "73H",
"registration" : "PHBXG"
}
},
"departure" : {
"airport" : {
"iataCode" : "LED",
"cityText" : "St. Petersburg"
},
"scheduled" : "2020-01-22T12:00:00+03:00",
"status" : "SC",
"statusText" : "Scheduled",
"terminal" : "3"
},
"arrival" : {
"airport" : {
"iataCode" : "AMS",
"cityText" : "Amsterdam"
},
"scheduled" : "2020-01-22T16:00:00+01:00",
"estimated" : "2020-01-22T15:47:00+01:00",
"status" : "AR",
"statusText" : "Arrived",
"terminal" : "3",
"gate" : "A9",
"carousel" : "15",
"gateSlots" : [ {
"externalName" : "A9"
} ]
},
"serviceType" : "J",
"duration" : "360"
}, {
"flightIdentifier" : {
"operatingCarrier" : {
"iataCode" : "KL",
"flightNumber" : "1394",
"name" : "KLM Royal Dutch Airlines"
},
"aircraft" : {
"iataCode" : "73H",
"registration" : "PHBXG"
}
},
"departure" : {
"airport" : {
"iataCode" : "LED",
"cityText" : "St. Petersburg"
},
"scheduled" : "2020-01-22T12:00:00+03:00",
"status" : "SC",
"statusText" : "Scheduled",
"terminal" : "3"
},
"arrival" : {
"airport" : {
"iataCode" : "AMS",
"cityText" : "Amsterdam"
},
"scheduled" : "2020-01-22T16:00:00+01:00",
"estimated" : "2020-01-22T15:47:00+01:00",
"actual" : "2020-01-22T15:47:00+01:00",
"status" : "AR",
"statusText" : "Arrived",
"terminal" : "3",
"gate" : "A9",
"carousel" : "15",
"gateSlots" : [ {
"externalName" : "A9"
} ]
},
"serviceType" : "J",
"duration" : "360"
}, {
"flightIdentifier" : {
"operatingCarrier" : {
"iataCode" : "KL",
"flightNumber" : "1394",
"name" : "KLM Royal Dutch Airlines"
},
"aircraft" : {
"iataCode" : "73H",
"registration" : "PHBXG"
}
},
"departure" : {
"airport" : {
"iataCode" : "LED",
"cityText" : "St. Petersburg"
},
"scheduled" : "2020-01-22T12:00:00+03:00",
"status" : "SC",
"statusText" : "Scheduled",
"terminal" : "3"
},
"arrival" : {
"airport" : {
"iataCode" : "AMS",
"cityText" : "Amsterdam"
},
"scheduled" : "2020-01-22T16:00:00+01:00",
"estimated" : "2020-01-22T15:47:00+01:00",
"actual" : "2020-01-22T15:47:00+01:00",
"status" : "AR",
"statusText" : "Arrived",
"terminal" : "3",
"gate" : "A9",
"carousel" : "15",
"gateSlots" : [ {
"externalName" : "A9"
} ]
},
"serviceType" : "J",
"duration" : "360"
} ]
}
2.2.1.5 GET Get Flight Updates by Airport and Airline
Retrieve all updates created within the from/to search window for flights arriving to or departing from an airport, operated or marketed by the provided airline.
Payload elements are filtered based on permissions associated with the 'x-apikey' used in the request.
Path parameters
Parameter | Description |
---|---|
| 3-character airport IATA code or 4-character airport ICAO code |
| 2-character airline IATA code or 3-character airline ICAO code |
Query parameters
Parameter | Description |
---|---|
| Date interval start e.g 2020-01-01T12:00:00-0000. Default is current UTC date/time - 2 minutes |
| Date interval end e.g 2020-01-01T12:05:00-0000. Default is current UTC date/time - 1 minutes |
| Show updated fields |
| Group marketing and operating carrier flights into a single record. Default value is false |
| Group updates in a single record |
| Show additional information such as version |
| Include cargo flights. Default value is false |
| 1-character direction indicator (A/D) |
Request headers
Name | Optional | Description |
---|---|---|
Content-Type | false | Content type of this request. Required value is 'application/json' |
Authorization | false | Authorization header that contains the access token. |
Response fields
Path | Type | Description |
---|---|---|
|
| Flight Records |
|
| Arrival |
|
| The actual local departure/arrival time for this flight e.g 2020-01-22T12:00:00+03:00 |
|
| Airport |
|
| The city in which the airport is located e.g New York |
|
| The city in which the airport is located e.g New York |
|
| 3-character airport IATA code e.g JFK |
|
| 4-character airport ICAO code e.g KJFK |
|
| The name of the airport e.g John F Kennedy International Airport |
|
| Expected carousel(s) for baggage reclaim |
|
| Carousel Slots |
|
| Location details of the slot resource i.e check-in desks1-20, Gate 2C etc |
|
| End time for the slot activity e.g check-in desk closed |
|
| Name used to identify the slot |
|
| Name used to identify the slot internally |
|
| Start time for the slot activity e.g check-in desk opened |
|
| Check-in desk details e.g CK-1 |
|
| Checkin Slots |
|
| Location details of the slot resource i.e check-in desks1-20, Gate 2C etc |
|
| End time for the slot activity e.g check-in desk closed |
|
| Name used to identify the slot |
|
| Name used to identify the slot internally |
|
| Start time for the slot activity e.g check-in desk opened |
|
| Baggage chute details e.g CH-2 |
|
| Chute Slots |
|
| Location details of the slot resource i.e check-in desks1-20, Gate 2C etc |
|
| End time for the slot activity e.g check-in desk closed |
|
| Name used to identify the slot |
|
| Name used to identify the slot internally |
|
| Start time for the slot activity e.g check-in desk opened |
|
| Custom Properties |
|
| Key value used to identify a custom property |
|
| The value of a custom property |
|
| Flight Diversion Details. |
|
| Flight Diversion original record |
|
| Airport |
|
| The city in which the airport is located e.g New York |
|
| The city in which the airport is located e.g New York |
|
| 3-character airport IATA code e.g JFK |
|
| 4-character airport ICAO code e.g KJFK |
|
| The name of the airport e.g John F Kennedy International Airport |
|
| Diversion flight original flight number |
|
| Diversion flight original airline iata code |
|
| Diversion flight original airline icao code |
|
| Diversion flight original airline name |
|
| Diversion flight original scheduled date of operation |
|
| Flight Diversion recovery record |
|
| Airport |
|
| The city in which the airport is located e.g New York |
|
| The city in which the airport is located e.g New York |
|
| 3-character airport IATA code e.g JFK |
|
| 4-character airport ICAO code e.g KJFK |
|
| The name of the airport e.g John F Kennedy International Airport |
|
| Diversion flight recovery flight number |
|
| Diversion flight recovery airline iata code |
|
| Diversion flight recovery airline icao code |
|
| Diversion flight recovery airline name |
|
| Diversion flight recovery scheduled date of operation |
|
| The latest estimated local departure/arrival time for this flight e.g 2020-01-22T12:00:00+03:00 |
|
| Flight events. |
|
| The actual local time at which the aircraft arrived at the gate |
|
| The actual local time at which the aircraft landed on the runway |
|
| The actual local time at which the aircraft left the gate |
|
| The actual local time at which the aircraft left the runway |
|
| The estimated local time at which the aircraft is expected at the gate |
|
| The estimated local time at which the aircraft is expected to land on the runway |
|
| The estimated local time at which the aircraft is expected to leave the gate |
|
| The estimated local time at which the aircraft is expected to leave the runway |
|
| The local time at which the aircraft is targeted to leave the gate |
|
| The local time at which the aircraft is targeted to leave the runway |
|
| The flights departure/arrival gate e.g C1 |
|
| Arrival gate remark |
|
| Gate remark text when applicable e.g Boarding at 21:00 |
|
| Gate Slots |
|
| Location details of the slot resource i.e check-in desks1-20, Gate 2C etc |
|
| End time for the slot activity e.g check-in desk closed |
|
| Name used to identify the slot |
|
| Name used to identify the slot internally |
|
| Start time for the slot activity e.g check-in desk opened |
|
| Route |
|
| 3-character airport IATA code |
|
| 4-character airport ICAO code |
|
| Value used to identify the routes position within an entire flight route e.g leg 0, leg 1, leg 2 etc |
|
| The published scheduled local departure/arrival time for this flight e.g 2020-01-22T12:00:00+03:00 |
|
| Aircraft stand details e.g S12 |
|
| Stand Slots |
|
| Location details of the slot resource i.e check-in desks1-20, Gate 2C etc |
|
| End time for the slot activity e.g check-in desk closed |
|
| Name used to identify the slot |
|
| Name used to identify the slot internally |
|
| Start time for the slot activity e.g check-in desk opened |
|
| The current status code for this flight e.g SC, DP |
|
| The current status text for this flight e.g Scheduled, Departed |
|
| The flights departure/arrival terminal e.g T1 |
|
| Updates |
|
| Current field value |
|
| UTC timestamp when update was applied (only visible when updates are grouped) |
|
| Data source of this update (only visible when updates are grouped) |
|
| Previous field value |
|
| UTC timestamp when update was received |
|
| Payload field which was updated |
|
| FLIFO internal version number |
|
| Departure |
|
| The actual local departure/arrival time for this flight e.g 2020-01-22T12:00:00+03:00 |
|
| Airport |
|
| The city in which the airport is located e.g New York |
|
| The city in which the airport is located e.g New York |
|
| 3-character airport IATA code e.g JFK |
|
| 4-character airport ICAO code e.g KJFK |
|
| The name of the airport e.g John F Kennedy International Airport |
|
| Expected carousel(s) for baggage reclaim |
|
| Carousel Slots |
|
| Location details of the slot resource i.e check-in desks1-20, Gate 2C etc |
|
| End time for the slot activity e.g check-in desk closed |
|
| Name used to identify the slot |
|
| Name used to identify the slot internally |
|
| Start time for the slot activity e.g check-in desk opened |
|
| Check-in desk details e.g CK-1 |
|
| Checkin Slots |
|
| Location details of the slot resource i.e check-in desks1-20, Gate 2C etc |
|
| End time for the slot activity e.g check-in desk closed |
|
| Name used to identify the slot |
|
| Name used to identify the slot internally |
|
| Start time for the slot activity e.g check-in desk opened |
|
| Baggage chute details e.g CH-2 |
|
| Chute Slots |
|
| Location details of the slot resource i.e check-in desks1-20, Gate 2C etc |
|
| End time for the slot activity e.g check-in desk closed |
|
| Name used to identify the slot |
|
| Name used to identify the slot internally |
|
| Start time for the slot activity e.g check-in desk opened |
|
| Custom Properties |
|
| Key value used to identify a custom property |
|
| The value of a custom property |
|
| Flight Diversion Details. |
|
| Flight Diversion original record |
|
| Airport |
|
| The city in which the airport is located e.g New York |
|
| The city in which the airport is located e.g New York |
|
| 3-character airport IATA code e.g JFK |
|
| 4-character airport ICAO code e.g KJFK |
|
| The name of the airport e.g John F Kennedy International Airport |
|
| Diversion flight original flight number |
|
| Diversion flight original airline iata code |
|
| Diversion flight original airline icao code |
|
| Diversion flight original airline name |
|
| Diversion flight original scheduled date of operation |
|
| Flight Diversion recovery record |
|
| Airport |
|
| The city in which the airport is located e.g New York |
|
| The city in which the airport is located e.g New York |
|
| 3-character airport IATA code e.g JFK |
|
| 4-character airport ICAO code e.g KJFK |
|
| The name of the airport e.g John F Kennedy International Airport |
|
| Diversion flight recovery flight number |
|
| Diversion flight recovery airline iata code |
|
| Diversion flight recovery airline icao code |
|
| Diversion flight recovery airline name |
|
| Diversion flight recovery scheduled date of operation |
|
| The latest estimated local departure/arrival time for this flight e.g 2020-01-22T12:00:00+03:00 |
|
| Flight events. |
|
| The actual local time at which the aircraft arrived at the gate |
|
| The actual local time at which the aircraft landed on the runway |
|
| The actual local time at which the aircraft left the gate |
|
| The actual local time at which the aircraft left the runway |
|
| The estimated local time at which the aircraft is expected at the gate |
|
| The estimated local time at which the aircraft is expected to land on the runway |
|
| The estimated local time at which the aircraft is expected to leave the gate |
|
| The estimated local time at which the aircraft is expected to leave the runway |
|
| The local time at which the aircraft is targeted to leave the gate |
|
| The local time at which the aircraft is targeted to leave the runway |
|
| The flights departure/arrival gate e.g C1 |
|
| Departure gate remark |
|
| Gate remark text when applicable e.g Boarding at 21:00 |
|
| Gate Slots |
|
| Location details of the slot resource i.e check-in desks1-20, Gate 2C etc |
|
| End time for the slot activity e.g check-in desk closed |
|
| Name used to identify the slot |
|
| Name used to identify the slot internally |
|
| Start time for the slot activity e.g check-in desk opened |
|
| Route |
|
| 3-character airport IATA code |
|
| 4-character airport ICAO code |
|
| Value used to identify the routes position within an entire flight route e.g leg 0, leg 1, leg 2 etc |
|
| The published scheduled local departure/arrival time for this flight e.g 2020-01-22T12:00:00+03:00 |
|
| Aircraft stand details e.g S12 |
|
| Stand Slots |
|
| Location details of the slot resource i.e check-in desks1-20, Gate 2C etc |
|
| End time for the slot activity e.g check-in desk closed |
|
| Name used to identify the slot |
|
| Name used to identify the slot internally |
|
| Start time for the slot activity e.g check-in desk opened |
|
| The current status code for this flight e.g SC, DP |
|
| The current status text for this flight e.g Scheduled, Departed |
|
| The flights departure/arrival terminal e.g T1 |
|
| Updates |
|
| Current field value |
|
| UTC timestamp when update was applied (only visible when updates are grouped) |
|
| Data source of this update (only visible when updates are grouped) |
|
| Previous field value |
|
| UTC timestamp when update was received |
|
| Payload field which was updated |
|
| FLIFO internal version number |
|
| Flight duration in minutes e.g 60 |
|
| Flight Identifier |
|
| Aircraft |
|
| Callsign for the aircraft type |
|
| IATA code for the aircraft |
|
| ICAO code for the aircraft |
|
| Specific aircraft model details |
|
| Aircraft regristration/tail number details e.g EIAA44W |
|
| A value that uniquely identifies a flight within the system |
|
| Marketing Carriers |
|
| Flight number e.g 1234 |
|
| 2-character airline IATA code e.g AA |
|
| 3-character airline ICAO code e.g AAL |
|
| Name of airline e.g American Airlines |
|
| Operating Carrier |
|
| Flight number e.g 1234 |
|
| 2-character airline IATA code e.g A |
|
| 3-character airline ICAO code e.g AAL |
|
| Name of airline e.g American Airlines |
|
| Flight Stats |
|
| Baggage |
|
| Total number of cargo pieces |
|
| Total number of bags/pieces |
|
| Load breakdown |
|
| Total number of mail pieces |
|
| Total weight of bags/pieces |
|
| Passengers |
|
| Actual number of business class passengers |
|
| Actual number of economy class passengers |
|
| Actual number of 1st class passengers |
|
| Actual number of passengers |
|
| Actual number of transfer passengers |
|
| Actual number of transit passengers |
|
| Total number of adults |
|
| Total number of booked business class passengers |
|
| Total number of booked economy class passengers |
|
| Total number of booked 1st class passengers |
|
| Total number of booked passengers |
|
| Total number of children |
|
| Total number of infants |
|
| Total number of reduced mobility passengers e.g those requiring assistance boarding the aircraft etc. |
|
| UTC timestamp when update was applied |
|
| Data source of this update |
|
| Flight service type e.g J-Passenger, F-Cargo |
|
| Group Marketing Carriers |
|
| Group Updates |
|
| Include Updates |
|
| Interval |
|
| From |
|
| Serial Version UID |
|
| To |
|
| Serial Version UID |
|
| Matched Records |
|
| Session Id |
|
| $ assertions Disabled |
|
| Least Sig Bits |
|
| Most Sig Bits |
|
| Serial Version UID |
Curl request
$ curl 'https://flifo.api.aero/flifo/flightinfo/v2/flights/updates/airport/AMS/airline/KL?from=2020-01-22T12:00:00.000Z&to=2020-01-22T13:00:00.000Z' -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: 18268
{
"sessionId" : "df1e6233-3534-430f-9f01-db8d4d85f856",
"interval" : {
"from" : "2020-01-22T10:00:00+00:00",
"to" : "2020-01-22T11:00:00+00:00"
},
"includeUpdates" : false,
"groupUpdates" : false,
"groupMarketingCarriers" : true,
"matchedRecords" : 22,
"flightRecords" : [ {
"flightIdentifier" : {
"operatingCarrier" : {
"iataCode" : "KL",
"flightNumber" : "1417",
"name" : "KLM Royal Dutch Airlines"
},
"aircraft" : {
"iataCode" : "73H",
"registration" : "PHBCD"
}
},
"departure" : {
"airport" : {
"iataCode" : "LYS",
"cityText" : "Lyon"
},
"scheduled" : "2020-01-22T16:00:00+01:00",
"status" : "SC",
"statusText" : "Scheduled",
"terminal" : "1",
"gate" : "C10",
"gateSlots" : [ {
"externalName" : "C10"
} ]
},
"serviceType" : "J",
"duration" : "240"
}, {
"flightIdentifier" : {
"operatingCarrier" : {
"iataCode" : "KL",
"flightNumber" : "1146",
"name" : "KLM Royal Dutch Airlines"
},
"marketingCarriers" : [ {
"iataCode" : "DL",
"flightNumber" : "9598",
"name" : "Delta Air Lines"
} ],
"aircraft" : {
"iataCode" : "EMJ",
"registration" : "PHEZH"
}
},
"arrival" : {
"airport" : {
"iataCode" : "OSL",
"cityText" : "Oslo"
},
"scheduled" : "2020-01-22T16:00:00+01:00",
"status" : "SC",
"statusText" : "Scheduled",
"terminal" : "2",
"gate" : "A4",
"carousel" : "9",
"gateSlots" : [ {
"externalName" : "A4"
} ]
},
"serviceType" : "J"
}, {
"flightIdentifier" : {
"operatingCarrier" : {
"iataCode" : "KL",
"flightNumber" : "937",
"name" : "KLM Royal Dutch Airlines"
},
"marketingCarriers" : [ {
"iataCode" : "DL",
"flightNumber" : "9428",
"name" : "Delta Air Lines"
} ],
"aircraft" : {
"iataCode" : "EMJ",
"registration" : "EIGGB"
}
},
"departure" : {
"airport" : {
"iataCode" : "DUB",
"cityText" : "Dublin"
},
"scheduled" : "2020-01-22T16:00:00+01:00",
"status" : "SC",
"statusText" : "Scheduled",
"terminal" : "2",
"gate" : "D6",
"gateSlots" : [ {
"externalName" : "D6"
} ]
},
"serviceType" : "J",
"duration" : "300"
}, {
"flightIdentifier" : {
"operatingCarrier" : {
"iataCode" : "KL",
"flightNumber" : "1394",
"name" : "KLM Royal Dutch Airlines"
},
"aircraft" : {
"iataCode" : "73H",
"registration" : "PHBXG"
}
},
"arrival" : {
"airport" : {
"iataCode" : "LED",
"cityText" : "St. Petersburg"
},
"scheduled" : "2020-01-22T16:00:00+01:00",
"status" : "SC",
"statusText" : "Scheduled",
"terminal" : "3",
"gate" : "A9",
"carousel" : "15",
"gateSlots" : [ {
"externalName" : "A9"
} ]
},
"serviceType" : "J"
}, {
"flightIdentifier" : {
"operatingCarrier" : {
"iataCode" : "KL",
"flightNumber" : "1386",
"name" : "KLM Royal Dutch Airlines"
},
"aircraft" : {
"iataCode" : "73H",
"registration" : "PHHSE"
}
},
"arrival" : {
"airport" : {
"iataCode" : "KBP",
"cityText" : "Kiev"
},
"scheduled" : "2020-01-22T16:00:00+01:00",
"status" : "SC",
"statusText" : "Scheduled",
"terminal" : "3",
"gate" : "A9",
"carousel" : "17",
"gateSlots" : [ {
"externalName" : "A9"
} ]
},
"serviceType" : "J"
}, {
"flightIdentifier" : {
"operatingCarrier" : {
"iataCode" : "KL",
"flightNumber" : "1417",
"name" : "KLM Royal Dutch Airlines"
},
"aircraft" : {
"iataCode" : "73H",
"registration" : "PHBCD"
}
},
"departure" : {
"airport" : {
"iataCode" : "LYS",
"cityText" : "Lyon"
},
"scheduled" : "2020-01-22T16:00:00+01:00",
"status" : "DP",
"statusText" : "Departed",
"terminal" : "1",
"gate" : "C10",
"gateSlots" : [ {
"externalName" : "C10"
} ]
},
"serviceType" : "J",
"duration" : "240"
}, {
"flightIdentifier" : {
"operatingCarrier" : {
"iataCode" : "KL",
"flightNumber" : "1417",
"name" : "KLM Royal Dutch Airlines"
},
"aircraft" : {
"iataCode" : "73H",
"registration" : "PHBCD"
}
},
"departure" : {
"airport" : {
"iataCode" : "LYS",
"cityText" : "Lyon"
},
"scheduled" : "2020-01-22T16:00:00+01:00",
"actual" : "2020-01-22T16:15:00+01:00",
"status" : "DP",
"statusText" : "Departed",
"terminal" : "1",
"gate" : "C10",
"gateSlots" : [ {
"externalName" : "C10"
} ]
},
"serviceType" : "J",
"duration" : "240"
}, {
"flightIdentifier" : {
"operatingCarrier" : {
"iataCode" : "KL",
"flightNumber" : "1417",
"name" : "KLM Royal Dutch Airlines"
},
"marketingCarriers" : [ {
"iataCode" : "AF",
"flightNumber" : "8291",
"name" : "Air France"
}, {
"iataCode" : "DL",
"flightNumber" : "9515",
"name" : "Delta Air Lines"
}, {
"iataCode" : "G3",
"flightNumber" : "5609",
"name" : "Sky Express"
} ],
"aircraft" : {
"iataCode" : "73H",
"registration" : "PHBCD"
}
},
"departure" : {
"airport" : {
"iataCode" : "LYS",
"cityText" : "Lyon"
},
"scheduled" : "2020-01-22T16:00:00+01:00",
"actual" : "2020-01-22T16:15:00+01:00",
"status" : "DP",
"statusText" : "Departed",
"terminal" : "1",
"gate" : "C10",
"gateSlots" : [ {
"externalName" : "C10"
} ]
},
"serviceType" : "J",
"duration" : "240"
}, {
"flightIdentifier" : {
"operatingCarrier" : {
"iataCode" : "KL",
"flightNumber" : "1394",
"name" : "KLM Royal Dutch Airlines"
},
"aircraft" : {
"iataCode" : "73H",
"registration" : "PHBXG"
}
},
"arrival" : {
"airport" : {
"iataCode" : "LED",
"cityText" : "St. Petersburg"
},
"scheduled" : "2020-01-22T16:00:00+01:00",
"status" : "AR",
"statusText" : "Arrived",
"terminal" : "3",
"gate" : "A9",
"carousel" : "15",
"gateSlots" : [ {
"externalName" : "A9"
} ]
},
"serviceType" : "J"
}, {
"flightIdentifier" : {
"operatingCarrier" : {
"iataCode" : "KL",
"flightNumber" : "1394",
"name" : "KLM Royal Dutch Airlines"
},
"aircraft" : {
"iataCode" : "73H",
"registration" : "PHBXG"
}
},
"arrival" : {
"airport" : {
"iataCode" : "LED",
"cityText" : "St. Petersburg"
},
"scheduled" : "2020-01-22T16:00:00+01:00",
"estimated" : "2020-01-22T15:47:00+01:00",
"status" : "AR",
"statusText" : "Arrived",
"terminal" : "3",
"gate" : "A9",
"carousel" : "15",
"gateSlots" : [ {
"externalName" : "A9"
} ]
},
"serviceType" : "J"
}, {
"flightIdentifier" : {
"operatingCarrier" : {
"iataCode" : "KL",
"flightNumber" : "1394",
"name" : "KLM Royal Dutch Airlines"
},
"aircraft" : {
"iataCode" : "73H",
"registration" : "PHBXG"
}
},
"arrival" : {
"airport" : {
"iataCode" : "LED",
"cityText" : "St. Petersburg"
},
"scheduled" : "2020-01-22T16:00:00+01:00",
"estimated" : "2020-01-22T15:47:00+01:00",
"actual" : "2020-01-22T15:47:00+01:00",
"status" : "AR",
"statusText" : "Arrived",
"terminal" : "3",
"gate" : "A9",
"carousel" : "15",
"gateSlots" : [ {
"externalName" : "A9"
} ]
},
"serviceType" : "J"
}, {
"flightIdentifier" : {
"operatingCarrier" : {
"iataCode" : "KL",
"flightNumber" : "1394",
"name" : "KLM Royal Dutch Airlines"
},
"marketingCarriers" : [ {
"iataCode" : "DL",
"flightNumber" : "8204",
"name" : "Delta Air Lines"
}, {
"iataCode" : "KQ",
"flightNumber" : "1394",
"name" : "Kenya Airways"
}, {
"iataCode" : "SU",
"flightNumber" : "3410",
"name" : "Aeroflot Russian Airlines"
} ],
"aircraft" : {
"iataCode" : "73H",
"registration" : "PHBXG"
}
},
"arrival" : {
"airport" : {
"iataCode" : "LED",
"cityText" : "St. Petersburg"
},
"scheduled" : "2020-01-22T16:00:00+01:00",
"estimated" : "2020-01-22T15:47:00+01:00",
"actual" : "2020-01-22T15:47:00+01:00",
"status" : "AR",
"statusText" : "Arrived",
"terminal" : "3",
"gate" : "A9",
"carousel" : "15",
"gateSlots" : [ {
"externalName" : "A9"
} ]
},
"serviceType" : "J"
}, {
"flightIdentifier" : {
"operatingCarrier" : {
"iataCode" : "KL",
"flightNumber" : "937",
"name" : "KLM Royal Dutch Airlines"
},
"marketingCarriers" : [ {
"iataCode" : "DL",
"flightNumber" : "9428",
"name" : "Delta Air Lines"
} ],
"aircraft" : {
"iataCode" : "EMJ",
"registration" : "EIGGB"
}
},
"departure" : {
"airport" : {
"iataCode" : "DUB",
"cityText" : "Dublin"
},
"scheduled" : "2020-01-22T16:00:00+01:00",
"status" : "DP",
"statusText" : "Departed",
"terminal" : "2",
"gate" : "D6",
"gateSlots" : [ {
"externalName" : "D6"
} ]
},
"serviceType" : "J",
"duration" : "300"
}, {
"flightIdentifier" : {
"operatingCarrier" : {
"iataCode" : "KL",
"flightNumber" : "937",
"name" : "KLM Royal Dutch Airlines"
},
"marketingCarriers" : [ {
"iataCode" : "DL",
"flightNumber" : "9428",
"name" : "Delta Air Lines"
} ],
"aircraft" : {
"iataCode" : "EMJ",
"registration" : "EIGGB"
}
},
"departure" : {
"airport" : {
"iataCode" : "DUB",
"cityText" : "Dublin"
},
"scheduled" : "2020-01-22T16:00:00+01:00",
"actual" : "2020-01-22T16:17:00+01:00",
"status" : "DP",
"statusText" : "Departed",
"terminal" : "2",
"gate" : "D6",
"gateSlots" : [ {
"externalName" : "D6"
} ]
},
"serviceType" : "J",
"duration" : "300"
}, {
"flightIdentifier" : {
"operatingCarrier" : {
"iataCode" : "KL",
"flightNumber" : "937",
"name" : "KLM Royal Dutch Airlines"
},
"marketingCarriers" : [ {
"iataCode" : "DL",
"flightNumber" : "9428",
"name" : "Delta Air Lines"
}, {
"iataCode" : "MF",
"flightNumber" : "9997",
"name" : "Xiamen Airlines"
} ],
"aircraft" : {
"iataCode" : "EMJ",
"registration" : "EIGGB"
}
},
"departure" : {
"airport" : {
"iataCode" : "DUB",
"cityText" : "Dublin"
},
"scheduled" : "2020-01-22T16:00:00+01:00",
"actual" : "2020-01-22T16:17:00+01:00",
"status" : "DP",
"statusText" : "Departed",
"terminal" : "2",
"gate" : "D6",
"gateSlots" : [ {
"externalName" : "D6"
} ]
},
"serviceType" : "J",
"duration" : "300"
}, {
"flightIdentifier" : {
"operatingCarrier" : {
"iataCode" : "KL",
"flightNumber" : "1146",
"name" : "KLM Royal Dutch Airlines"
},
"marketingCarriers" : [ {
"iataCode" : "DL",
"flightNumber" : "9598",
"name" : "Delta Air Lines"
} ],
"aircraft" : {
"iataCode" : "EMJ",
"registration" : "PHEZH"
}
},
"arrival" : {
"airport" : {
"iataCode" : "OSL",
"cityText" : "Oslo"
},
"scheduled" : "2020-01-22T16:00:00+01:00",
"status" : "AR",
"statusText" : "Arrived",
"terminal" : "2",
"gate" : "A4",
"carousel" : "9",
"gateSlots" : [ {
"externalName" : "A4"
} ]
},
"serviceType" : "J"
}, {
"flightIdentifier" : {
"operatingCarrier" : {
"iataCode" : "KL",
"flightNumber" : "1146",
"name" : "KLM Royal Dutch Airlines"
},
"marketingCarriers" : [ {
"iataCode" : "DL",
"flightNumber" : "9598",
"name" : "Delta Air Lines"
} ],
"aircraft" : {
"iataCode" : "EMJ",
"registration" : "PHEZH"
}
},
"arrival" : {
"airport" : {
"iataCode" : "OSL",
"cityText" : "Oslo"
},
"scheduled" : "2020-01-22T16:00:00+01:00",
"estimated" : "2020-01-22T16:03:00+01:00",
"status" : "AR",
"statusText" : "Arrived",
"terminal" : "2",
"gate" : "A4",
"carousel" : "9",
"gateSlots" : [ {
"externalName" : "A4"
} ]
},
"serviceType" : "J"
}, {
"flightIdentifier" : {
"operatingCarrier" : {
"iataCode" : "KL",
"flightNumber" : "1146",
"name" : "KLM Royal Dutch Airlines"
},
"marketingCarriers" : [ {
"iataCode" : "DL",
"flightNumber" : "9598",
"name" : "Delta Air Lines"
} ],
"aircraft" : {
"iataCode" : "EMJ",
"registration" : "PHEZH"
}
},
"arrival" : {
"airport" : {
"iataCode" : "OSL",
"cityText" : "Oslo"
},
"scheduled" : "2020-01-22T16:00:00+01:00",
"estimated" : "2020-01-22T16:03:00+01:00",
"actual" : "2020-01-22T16:03:00+01:00",
"status" : "AR",
"statusText" : "Arrived",
"terminal" : "2",
"gate" : "A4",
"carousel" : "9",
"gateSlots" : [ {
"externalName" : "A4"
} ]
},
"serviceType" : "J"
}, {
"flightIdentifier" : {
"operatingCarrier" : {
"iataCode" : "KL",
"flightNumber" : "1386",
"name" : "KLM Royal Dutch Airlines"
},
"aircraft" : {
"iataCode" : "73H",
"registration" : "PHHSE"
}
},
"arrival" : {
"airport" : {
"iataCode" : "KBP",
"cityText" : "Kiev"
},
"scheduled" : "2020-01-22T16:00:00+01:00",
"status" : "AR",
"statusText" : "Arrived",
"terminal" : "3",
"gate" : "A9",
"carousel" : "17",
"gateSlots" : [ {
"externalName" : "A9"
} ]
},
"serviceType" : "J"
}, {
"flightIdentifier" : {
"operatingCarrier" : {
"iataCode" : "KL",
"flightNumber" : "1386",
"name" : "KLM Royal Dutch Airlines"
},
"aircraft" : {
"iataCode" : "73H",
"registration" : "PHHSE"
}
},
"arrival" : {
"airport" : {
"iataCode" : "KBP",
"cityText" : "Kiev"
},
"scheduled" : "2020-01-22T16:00:00+01:00",
"estimated" : "2020-01-22T15:44:00+01:00",
"status" : "AR",
"statusText" : "Arrived",
"terminal" : "3",
"gate" : "A9",
"carousel" : "17",
"gateSlots" : [ {
"externalName" : "A9"
} ]
},
"serviceType" : "J"
}, {
"flightIdentifier" : {
"operatingCarrier" : {
"iataCode" : "KL",
"flightNumber" : "1386",
"name" : "KLM Royal Dutch Airlines"
},
"aircraft" : {
"iataCode" : "73H",
"registration" : "PHHSE"
}
},
"arrival" : {
"airport" : {
"iataCode" : "KBP",
"cityText" : "Kiev"
},
"scheduled" : "2020-01-22T16:00:00+01:00",
"estimated" : "2020-01-22T15:44:00+01:00",
"actual" : "2020-01-22T15:44:00+01:00",
"status" : "AR",
"statusText" : "Arrived",
"terminal" : "3",
"gate" : "A9",
"carousel" : "17",
"gateSlots" : [ {
"externalName" : "A9"
} ]
},
"serviceType" : "J"
}, {
"flightIdentifier" : {
"operatingCarrier" : {
"iataCode" : "KL",
"flightNumber" : "1386",
"name" : "KLM Royal Dutch Airlines"
},
"marketingCarriers" : [ {
"iataCode" : "DL",
"flightNumber" : "9473",
"name" : "Delta Air Lines"
}, {
"iataCode" : "PS",
"flightNumber" : "9386",
"name" : "Ukraine International Airlines"
} ],
"aircraft" : {
"iataCode" : "73H",
"registration" : "PHHSE"
}
},
"arrival" : {
"airport" : {
"iataCode" : "KBP",
"cityText" : "Kiev"
},
"scheduled" : "2020-01-22T16:00:00+01:00",
"estimated" : "2020-01-22T15:44:00+01:00",
"actual" : "2020-01-22T15:44:00+01:00",
"status" : "AR",
"statusText" : "Arrived",
"terminal" : "3",
"gate" : "A9",
"carousel" : "17",
"gateSlots" : [ {
"externalName" : "A9"
} ]
},
"serviceType" : "J"
} ]
}
2.2.1.6 GET Get Flight Updates by Airport
Retrieve all updates created within the from/to search window for flights arriving to or departing from an airport.
Payload elements are filtered based on permissions associated with the 'x-apikey' used in the request.
Path parameters
Parameter | Description |
---|---|
| 3-character airport IATA code or 4-character airport ICAO code |
Query parameters
Parameter | Description |
---|---|
| Date interval start e.g 2020-01-01T12:00:00-0000. Default is current UTC date/time - 2 minutes |
| Date interval end e.g 2020-01-01T12:05:00-0000. Default is current UTC date/time - 1 minutes |
| Show updated fields |
| Group marketing and operating carrier flights into a single record. Default value is false |
| Group updates in a single record |
| Show additional information such as version |
| Include cargo flights. Default value is false |
| 1-character direction indicator (A/D) |
Request headers
Name | Optional | Description |
---|---|---|
Content-Type | false | Content type of this request. Required value is 'application/json' |
Authorization | false | Authorization header that contains the access token. |
Response fields
Path | Type | Description |
---|---|---|
|
| Flight Records |
|
| Arrival |
|
| The actual local departure/arrival time for this flight e.g 2020-01-22T12:00:00+03:00 |
|
| Airport |
|
| The city in which the airport is located e.g New York |
|
| The city in which the airport is located e.g New York |
|
| 3-character airport IATA code e.g JFK |
|
| 4-character airport ICAO code e.g KJFK |
|
| The name of the airport e.g John F Kennedy International Airport |
|
| Expected carousel(s) for baggage reclaim |
|
| Carousel Slots |
|
| Location details of the slot resource i.e check-in desks1-20, Gate 2C etc |
|
| End time for the slot activity e.g check-in desk closed |
|
| Name used to identify the slot |
|
| Name used to identify the slot internally |
|
| Start time for the slot activity e.g check-in desk opened |
|
| Check-in desk details e.g CK-1 |
|
| Checkin Slots |
|
| Location details of the slot resource i.e check-in desks1-20, Gate 2C etc |
|
| End time for the slot activity e.g check-in desk closed |
|
| Name used to identify the slot |
|
| Name used to identify the slot internally |
|
| Start time for the slot activity e.g check-in desk opened |
|
| Baggage chute details e.g CH-2 |
|
| Chute Slots |
|
| Location details of the slot resource i.e check-in desks1-20, Gate 2C etc |
|
| End time for the slot activity e.g check-in desk closed |
|
| Name used to identify the slot |
|
| Name used to identify the slot internally |
|
| Start time for the slot activity e.g check-in desk opened |
|
| Custom Properties |
|
| Key value used to identify a custom property |
|
| The value of a custom property |
|
| Flight Diversion Details. |
|
| Flight Diversion original record |
|
| Airport |
|
| The city in which the airport is located e.g New York |
|
| The city in which the airport is located e.g New York |
|
| 3-character airport IATA code e.g JFK |
|
| 4-character airport ICAO code e.g KJFK |
|
| The name of the airport e.g John F Kennedy International Airport |
|
| Diversion flight original flight number |
|
| Diversion flight original airline iata code |
|
| Diversion flight original airline icao code |
|
| Diversion flight original airline name |
|
| Diversion flight original scheduled date of operation |
|
| Flight Diversion recovery record |
|
| Airport |
|
| The city in which the airport is located e.g New York |
|
| The city in which the airport is located e.g New York |
|
| 3-character airport IATA code e.g JFK |
|
| 4-character airport ICAO code e.g KJFK |
|
| The name of the airport e.g John F Kennedy International Airport |
|
| Diversion flight recovery flight number |
|
| Diversion flight recovery airline iata code |
|
| Diversion flight recovery airline icao code |
|
| Diversion flight recovery airline name |
|
| Diversion flight recovery scheduled date of operation |
|
| The latest estimated local departure/arrival time for this flight e.g 2020-01-22T12:00:00+03:00 |
|
| Flight events. |
|
| The actual local time at which the aircraft arrived at the gate |
|
| The actual local time at which the aircraft landed on the runway |
|
| The actual local time at which the aircraft left the gate |
|
| The actual local time at which the aircraft left the runway |
|
| The estimated local time at which the aircraft is expected at the gate |
|
| The estimated local time at which the aircraft is expected to land on the runway |
|
| The estimated local time at which the aircraft is expected to leave the gate |
|
| The estimated local time at which the aircraft is expected to leave the runway |
|
| The local time at which the aircraft is targeted to leave the gate |
|
| The local time at which the aircraft is targeted to leave the runway |
|
| The flights departure/arrival gate e.g C1 |
|
| Arrival gate remark |
|
| Gate remark text when applicable e.g Boarding at 21:00 |
|
| Gate Slots |
|
| Location details of the slot resource i.e check-in desks1-20, Gate 2C etc |
|
| End time for the slot activity e.g check-in desk closed |
|
| Name used to identify the slot |
|
| Name used to identify the slot internally |
|
| Start time for the slot activity e.g check-in desk opened |
|
| Route |
|
| 3-character airport IATA code |
|
| 4-character airport ICAO code |
|
| Value used to identify the routes position within an entire flight route e.g leg 0, leg 1, leg 2 etc |
|
| The published scheduled local departure/arrival time for this flight e.g 2020-01-22T12:00:00+03:00 |
|
| Aircraft stand details e.g S12 |
|
| Stand Slots |
|
| Location details of the slot resource i.e check-in desks1-20, Gate 2C etc |
|
| End time for the slot activity e.g check-in desk closed |
|
| Name used to identify the slot |
|
| Name used to identify the slot internally |
|
| Start time for the slot activity e.g check-in desk opened |
|
| The current status code for this flight e.g SC, DP |
|
| The current status text for this flight e.g Scheduled, Departed |
|
| The flights departure/arrival terminal e.g T1 |
|
| Updates |
|
| Current field value |
|
| UTC timestamp when update was applied (only visible when updates are grouped) |
|
| Data source of this update (only visible when updates are grouped) |
|
| Previous field value |
|
| UTC timestamp when update was received |
|
| Payload field which was updated |
|
| FLIFO internal version number |
|
| Departure |
|
| The actual local departure/arrival time for this flight e.g 2020-01-22T12:00:00+03:00 |
|
| Airport |
|
| The city in which the airport is located e.g New York |
|
| The city in which the airport is located e.g New York |
|
| 3-character airport IATA code e.g JFK |
|
| 4-character airport ICAO code e.g KJFK |
|
| The name of the airport e.g John F Kennedy International Airport |
|
| Expected carousel(s) for baggage reclaim |
|
| Carousel Slots |
|
| Location details of the slot resource i.e check-in desks1-20, Gate 2C etc |
|
| End time for the slot activity e.g check-in desk closed |
|
| Name used to identify the slot |
|
| Name used to identify the slot internally |
|
| Start time for the slot activity e.g check-in desk opened |
|
| Check-in desk details e.g CK-1 |
|
| Checkin Slots |
|
| Location details of the slot resource i.e check-in desks1-20, Gate 2C etc |
|
| End time for the slot activity e.g check-in desk closed |
|
| Name used to identify the slot |
|
| Name used to identify the slot internally |
|
| Start time for the slot activity e.g check-in desk opened |
|
| Baggage chute details e.g CH-2 |
|
| Chute Slots |
|
| Location details of the slot resource i.e check-in desks1-20, Gate 2C etc |
|
| End time for the slot activity e.g check-in desk closed |
|
| Name used to identify the slot |
|
| Name used to identify the slot internally |
|
| Start time for the slot activity e.g check-in desk opened |
|
| Custom Properties |
|
| Key value used to identify a custom property |
|
| The value of a custom property |
|
| Flight Diversion Details. |
|
| Flight Diversion original record |
|
| Airport |
|
| The city in which the airport is located e.g New York |
|
| The city in which the airport is located e.g New York |
|
| 3-character airport IATA code e.g JFK |
|
| 4-character airport ICAO code e.g KJFK |
|
| The name of the airport e.g John F Kennedy International Airport |
|
| Diversion flight original flight number |
|
| Diversion flight original airline iata code |
|
| Diversion flight original airline icao code |
|
| Diversion flight original airline name |
|
| Diversion flight original scheduled date of operation |
|
| Flight Diversion recovery record |
|
| Airport |
|
| The city in which the airport is located e.g New York |
|
| The city in which the airport is located e.g New York |
|
| 3-character airport IATA code e.g JFK |
|
| 4-character airport ICAO code e.g KJFK |
|
| The name of the airport e.g John F Kennedy International Airport |
|
| Diversion flight recovery flight number |
|
| Diversion flight recovery airline iata code |
|
| Diversion flight recovery airline icao code |
|
| Diversion flight recovery airline name |
|
| Diversion flight recovery scheduled date of operation |
|
| The latest estimated local departure/arrival time for this flight e.g 2020-01-22T12:00:00+03:00 |
|
| Flight events. |
|
| The actual local time at which the aircraft arrived at the gate |
|
| The actual local time at which the aircraft landed on the runway |
|
| The actual local time at which the aircraft left the gate |
|
| The actual local time at which the aircraft left the runway |
|
| The estimated local time at which the aircraft is expected at the gate |
|
| The estimated local time at which the aircraft is expected to land on the runway |
|
| The estimated local time at which the aircraft is expected to leave the gate |
|
| The estimated local time at which the aircraft is expected to leave the runway |
|
| The local time at which the aircraft is targeted to leave the gate |
|
| The local time at which the aircraft is targeted to leave the runway |
|
| The flights departure/arrival gate e.g C1 |
|
| Departure gate remark |
|
| Gate remark text when applicable e.g Boarding at 21:00 |
|
| Gate Slots |
|
| Location details of the slot resource i.e check-in desks1-20, Gate 2C etc |
|
| End time for the slot activity e.g check-in desk closed |
|
| Name used to identify the slot |
|
| Name used to identify the slot internally |
|
| Start time for the slot activity e.g check-in desk opened |
|
| Route |
|
| 3-character airport IATA code |
|
| 4-character airport ICAO code |
|
| Value used to identify the routes position within an entire flight route e.g leg 0, leg 1, leg 2 etc |
|
| The published scheduled local departure/arrival time for this flight e.g 2020-01-22T12:00:00+03:00 |
|
| Aircraft stand details e.g S12 |
|
| Stand Slots |
|
| Location details of the slot resource i.e check-in desks1-20, Gate 2C etc |
|
| End time for the slot activity e.g check-in desk closed |
|
| Name used to identify the slot |
|
| Name used to identify the slot internally |
|
| Start time for the slot activity e.g check-in desk opened |
|
| The current status code for this flight e.g SC, DP |
|
| The current status text for this flight e.g Scheduled, Departed |
|
| The flights departure/arrival terminal e.g T1 |
|
| Updates |
|
| Current field value |
|
| UTC timestamp when update was applied (only visible when updates are grouped) |
|
| Data source of this update (only visible when updates are grouped) |
|
| Previous field value |
|
| UTC timestamp when update was received |
|
| Payload field which was updated |
|
| FLIFO internal version number |
|
| Flight duration in minutes e.g 60 |
|
| Flight Identifier |
|
| Aircraft |
|
| Callsign for the aircraft type |
|
| IATA code for the aircraft |
|
| ICAO code for the aircraft |
|
| Specific aircraft model details |
|
| Aircraft regristration/tail number details e.g EIAA44W |
|
| A value that uniquely identifies a flight within the system |
|
| Marketing Carriers |
|
| Flight number e.g 1234 |
|
| 2-character airline IATA code e.g AA |
|
| 3-character airline ICAO code e.g AAL |
|
| Name of airline e.g American Airlines |
|
| Operating Carrier |
|
| Flight number e.g 1234 |
|
| 2-character airline IATA code e.g A |
|
| 3-character airline ICAO code e.g AAL |
|
| Name of airline e.g American Airlines |
|
| Flight Stats |
|
| Baggage |
|
| Total number of cargo pieces |
|
| Total number of bags/pieces |
|
| Load breakdown |
|
| Total number of mail pieces |
|
| Total weight of bags/pieces |
|
| Passengers |
|
| Actual number of business class passengers |
|
| Actual number of economy class passengers |
|
| Actual number of 1st class passengers |
|
| Actual number of passengers |
|
| Actual number of transfer passengers |
|
| Actual number of transit passengers |
|
| Total number of adults |
|
| Total number of booked business class passengers |
|
| Total number of booked economy class passengers |
|
| Total number of booked 1st class passengers |
|
| Total number of booked passengers |
|
| Total number of children |
|
| Total number of infants |
|
| Total number of reduced mobility passengers e.g those requiring assistance boarding the aircraft etc. |
|
| UTC timestamp when update was applied |
|
| Data source of this update |
|
| Flight service type e.g J-Passenger, F-Cargo |
|
| Group Marketing Carriers |
|
| Group Updates |
|
| Include Updates |
|
| Interval |
|
| From |
|
| Serial Version UID |
|
| To |
|
| Serial Version UID |
|
| Matched Records |
|
| Session Id |
|
| $ assertions Disabled |
|
| Least Sig Bits |
|
| Most Sig Bits |
|
| Serial Version UID |
Curl request
$ curl 'https://flifo.api.aero/flifo/flightinfo/v2/flights/updates/airport/AMS?from=2020-01-22T12:00:00.000Z&to=2020-01-22T13:00:00.000Z' -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: 18268
{
"sessionId" : "df1e6233-3534-430f-9f01-db8d4d85f856",
"interval" : {
"from" : "2020-01-22T10:00:00+00:00",
"to" : "2020-01-22T11:00:00+00:00"
},
"includeUpdates" : false,
"groupUpdates" : false,
"groupMarketingCarriers" : true,
"matchedRecords" : 22,
"flightRecords" : [ {
"flightIdentifier" : {
"operatingCarrier" : {
"iataCode" : "KL",
"flightNumber" : "1417",
"name" : "KLM Royal Dutch Airlines"
},
"aircraft" : {
"iataCode" : "73H",
"registration" : "PHBCD"
}
},
"departure" : {
"airport" : {
"iataCode" : "LYS",
"cityText" : "Lyon"
},
"scheduled" : "2020-01-22T16:00:00+01:00",
"status" : "SC",
"statusText" : "Scheduled",
"terminal" : "1",
"gate" : "C10",
"gateSlots" : [ {
"externalName" : "C10"
} ]
},
"serviceType" : "J",
"duration" : "240"
}, {
"flightIdentifier" : {
"operatingCarrier" : {
"iataCode" : "KL",
"flightNumber" : "1146",
"name" : "KLM Royal Dutch Airlines"
},
"marketingCarriers" : [ {
"iataCode" : "DL",
"flightNumber" : "9598",
"name" : "Delta Air Lines"
} ],
"aircraft" : {
"iataCode" : "EMJ",
"registration" : "PHEZH"
}
},
"arrival" : {
"airport" : {
"iataCode" : "OSL",
"cityText" : "Oslo"
},
"scheduled" : "2020-01-22T16:00:00+01:00",
"status" : "SC",
"statusText" : "Scheduled",
"terminal" : "2",
"gate" : "A4",
"carousel" : "9",
"gateSlots" : [ {
"externalName" : "A4"
} ]
},
"serviceType" : "J"
}, {
"flightIdentifier" : {
"operatingCarrier" : {
"iataCode" : "KL",
"flightNumber" : "937",
"name" : "KLM Royal Dutch Airlines"
},
"marketingCarriers" : [ {
"iataCode" : "DL",
"flightNumber" : "9428",
"name" : "Delta Air Lines"
} ],
"aircraft" : {
"iataCode" : "EMJ",
"registration" : "EIGGB"
}
},
"departure" : {
"airport" : {
"iataCode" : "DUB",
"cityText" : "Dublin"
},
"scheduled" : "2020-01-22T16:00:00+01:00",
"status" : "SC",
"statusText" : "Scheduled",
"terminal" : "2",
"gate" : "D6",
"gateSlots" : [ {
"externalName" : "D6"
} ]
},
"serviceType" : "J",
"duration" : "300"
}, {
"flightIdentifier" : {
"operatingCarrier" : {
"iataCode" : "KL",
"flightNumber" : "1394",
"name" : "KLM Royal Dutch Airlines"
},
"aircraft" : {
"iataCode" : "73H",
"registration" : "PHBXG"
}
},
"arrival" : {
"airport" : {
"iataCode" : "LED",
"cityText" : "St. Petersburg"
},
"scheduled" : "2020-01-22T16:00:00+01:00",
"status" : "SC",
"statusText" : "Scheduled",
"terminal" : "3",
"gate" : "A9",
"carousel" : "15",
"gateSlots" : [ {
"externalName" : "A9"
} ]
},
"serviceType" : "J"
}, {
"flightIdentifier" : {
"operatingCarrier" : {
"iataCode" : "KL",
"flightNumber" : "1386",
"name" : "KLM Royal Dutch Airlines"
},
"aircraft" : {
"iataCode" : "73H",
"registration" : "PHHSE"
}
},
"arrival" : {
"airport" : {
"iataCode" : "KBP",
"cityText" : "Kiev"
},
"scheduled" : "2020-01-22T16:00:00+01:00",
"status" : "SC",
"statusText" : "Scheduled",
"terminal" : "3",
"gate" : "A9",
"carousel" : "17",
"gateSlots" : [ {
"externalName" : "A9"
} ]
},
"serviceType" : "J"
}, {
"flightIdentifier" : {
"operatingCarrier" : {
"iataCode" : "KL",
"flightNumber" : "1417",
"name" : "KLM Royal Dutch Airlines"
},
"aircraft" : {
"iataCode" : "73H",
"registration" : "PHBCD"
}
},
"departure" : {
"airport" : {
"iataCode" : "LYS",
"cityText" : "Lyon"
},
"scheduled" : "2020-01-22T16:00:00+01:00",
"status" : "DP",
"statusText" : "Departed",
"terminal" : "1",
"gate" : "C10",
"gateSlots" : [ {
"externalName" : "C10"
} ]
},
"serviceType" : "J",
"duration" : "240"
}, {
"flightIdentifier" : {
"operatingCarrier" : {
"iataCode" : "KL",
"flightNumber" : "1417",
"name" : "KLM Royal Dutch Airlines"
},
"aircraft" : {
"iataCode" : "73H",
"registration" : "PHBCD"
}
},
"departure" : {
"airport" : {
"iataCode" : "LYS",
"cityText" : "Lyon"
},
"scheduled" : "2020-01-22T16:00:00+01:00",
"actual" : "2020-01-22T16:15:00+01:00",
"status" : "DP",
"statusText" : "Departed",
"terminal" : "1",
"gate" : "C10",
"gateSlots" : [ {
"externalName" : "C10"
} ]
},
"serviceType" : "J",
"duration" : "240"
}, {
"flightIdentifier" : {
"operatingCarrier" : {
"iataCode" : "KL",
"flightNumber" : "1417",
"name" : "KLM Royal Dutch Airlines"
},
"marketingCarriers" : [ {
"iataCode" : "AF",
"flightNumber" : "8291",
"name" : "Air France"
}, {
"iataCode" : "DL",
"flightNumber" : "9515",
"name" : "Delta Air Lines"
}, {
"iataCode" : "G3",
"flightNumber" : "5609",
"name" : "Sky Express"
} ],
"aircraft" : {
"iataCode" : "73H",
"registration" : "PHBCD"
}
},
"departure" : {
"airport" : {
"iataCode" : "LYS",
"cityText" : "Lyon"
},
"scheduled" : "2020-01-22T16:00:00+01:00",
"actual" : "2020-01-22T16:15:00+01:00",
"status" : "DP",
"statusText" : "Departed",
"terminal" : "1",
"gate" : "C10",
"gateSlots" : [ {
"externalName" : "C10"
} ]
},
"serviceType" : "J",
"duration" : "240"
}, {
"flightIdentifier" : {
"operatingCarrier" : {
"iataCode" : "KL",
"flightNumber" : "1394",
"name" : "KLM Royal Dutch Airlines"
},
"aircraft" : {
"iataCode" : "73H",
"registration" : "PHBXG"
}
},
"arrival" : {
"airport" : {
"iataCode" : "LED",
"cityText" : "St. Petersburg"
},
"scheduled" : "2020-01-22T16:00:00+01:00",
"status" : "AR",
"statusText" : "Arrived",
"terminal" : "3",
"gate" : "A9",
"carousel" : "15",
"gateSlots" : [ {
"externalName" : "A9"
} ]
},
"serviceType" : "J"
}, {
"flightIdentifier" : {
"operatingCarrier" : {
"iataCode" : "KL",
"flightNumber" : "1394",
"name" : "KLM Royal Dutch Airlines"
},
"aircraft" : {
"iataCode" : "73H",
"registration" : "PHBXG"
}
},
"arrival" : {
"airport" : {
"iataCode" : "LED",
"cityText" : "St. Petersburg"
},
"scheduled" : "2020-01-22T16:00:00+01:00",
"estimated" : "2020-01-22T15:47:00+01:00",
"status" : "AR",
"statusText" : "Arrived",
"terminal" : "3",
"gate" : "A9",
"carousel" : "15",
"gateSlots" : [ {
"externalName" : "A9"
} ]
},
"serviceType" : "J"
}, {
"flightIdentifier" : {
"operatingCarrier" : {
"iataCode" : "KL",
"flightNumber" : "1394",
"name" : "KLM Royal Dutch Airlines"
},
"aircraft" : {
"iataCode" : "73H",
"registration" : "PHBXG"
}
},
"arrival" : {
"airport" : {
"iataCode" : "LED",
"cityText" : "St. Petersburg"
},
"scheduled" : "2020-01-22T16:00:00+01:00",
"estimated" : "2020-01-22T15:47:00+01:00",
"actual" : "2020-01-22T15:47:00+01:00",
"status" : "AR",
"statusText" : "Arrived",
"terminal" : "3",
"gate" : "A9",
"carousel" : "15",
"gateSlots" : [ {
"externalName" : "A9"
} ]
},
"serviceType" : "J"
}, {
"flightIdentifier" : {
"operatingCarrier" : {
"iataCode" : "KL",
"flightNumber" : "1394",
"name" : "KLM Royal Dutch Airlines"
},
"marketingCarriers" : [ {
"iataCode" : "DL",
"flightNumber" : "8204",
"name" : "Delta Air Lines"
}, {
"iataCode" : "KQ",
"flightNumber" : "1394",
"name" : "Kenya Airways"
}, {
"iataCode" : "SU",
"flightNumber" : "3410",
"name" : "Aeroflot Russian Airlines"
} ],
"aircraft" : {
"iataCode" : "73H",
"registration" : "PHBXG"
}
},
"arrival" : {
"airport" : {
"iataCode" : "LED",
"cityText" : "St. Petersburg"
},
"scheduled" : "2020-01-22T16:00:00+01:00",
"estimated" : "2020-01-22T15:47:00+01:00",
"actual" : "2020-01-22T15:47:00+01:00",
"status" : "AR",
"statusText" : "Arrived",
"terminal" : "3",
"gate" : "A9",
"carousel" : "15",
"gateSlots" : [ {
"externalName" : "A9"
} ]
},
"serviceType" : "J"
}, {
"flightIdentifier" : {
"operatingCarrier" : {
"iataCode" : "KL",
"flightNumber" : "937",
"name" : "KLM Royal Dutch Airlines"
},
"marketingCarriers" : [ {
"iataCode" : "DL",
"flightNumber" : "9428",
"name" : "Delta Air Lines"
} ],
"aircraft" : {
"iataCode" : "EMJ",
"registration" : "EIGGB"
}
},
"departure" : {
"airport" : {
"iataCode" : "DUB",
"cityText" : "Dublin"
},
"scheduled" : "2020-01-22T16:00:00+01:00",
"status" : "DP",
"statusText" : "Departed",
"terminal" : "2",
"gate" : "D6",
"gateSlots" : [ {
"externalName" : "D6"
} ]
},
"serviceType" : "J",
"duration" : "300"
}, {
"flightIdentifier" : {
"operatingCarrier" : {
"iataCode" : "KL",
"flightNumber" : "937",
"name" : "KLM Royal Dutch Airlines"
},
"marketingCarriers" : [ {
"iataCode" : "DL",
"flightNumber" : "9428",
"name" : "Delta Air Lines"
} ],
"aircraft" : {
"iataCode" : "EMJ",
"registration" : "EIGGB"
}
},
"departure" : {
"airport" : {
"iataCode" : "DUB",
"cityText" : "Dublin"
},
"scheduled" : "2020-01-22T16:00:00+01:00",
"actual" : "2020-01-22T16:17:00+01:00",
"status" : "DP",
"statusText" : "Departed",
"terminal" : "2",
"gate" : "D6",
"gateSlots" : [ {
"externalName" : "D6"
} ]
},
"serviceType" : "J",
"duration" : "300"
}, {
"flightIdentifier" : {
"operatingCarrier" : {
"iataCode" : "KL",
"flightNumber" : "937",
"name" : "KLM Royal Dutch Airlines"
},
"marketingCarriers" : [ {
"iataCode" : "DL",
"flightNumber" : "9428",
"name" : "Delta Air Lines"
}, {
"iataCode" : "MF",
"flightNumber" : "9997",
"name" : "Xiamen Airlines"
} ],
"aircraft" : {
"iataCode" : "EMJ",
"registration" : "EIGGB"
}
},
"departure" : {
"airport" : {
"iataCode" : "DUB",
"cityText" : "Dublin"
},
"scheduled" : "2020-01-22T16:00:00+01:00",
"actual" : "2020-01-22T16:17:00+01:00",
"status" : "DP",
"statusText" : "Departed",
"terminal" : "2",
"gate" : "D6",
"gateSlots" : [ {
"externalName" : "D6"
} ]
},
"serviceType" : "J",
"duration" : "300"
}, {
"flightIdentifier" : {
"operatingCarrier" : {
"iataCode" : "KL",
"flightNumber" : "1146",
"name" : "KLM Royal Dutch Airlines"
},
"marketingCarriers" : [ {
"iataCode" : "DL",
"flightNumber" : "9598",
"name" : "Delta Air Lines"
} ],
"aircraft" : {
"iataCode" : "EMJ",
"registration" : "PHEZH"
}
},
"arrival" : {
"airport" : {
"iataCode" : "OSL",
"cityText" : "Oslo"
},
"scheduled" : "2020-01-22T16:00:00+01:00",
"status" : "AR",
"statusText" : "Arrived",
"terminal" : "2",
"gate" : "A4",
"carousel" : "9",
"gateSlots" : [ {
"externalName" : "A4"
} ]
},
"serviceType" : "J"
}, {
"flightIdentifier" : {
"operatingCarrier" : {
"iataCode" : "KL",
"flightNumber" : "1146",
"name" : "KLM Royal Dutch Airlines"
},
"marketingCarriers" : [ {
"iataCode" : "DL",
"flightNumber" : "9598",
"name" : "Delta Air Lines"
} ],
"aircraft" : {
"iataCode" : "EMJ",
"registration" : "PHEZH"
}
},
"arrival" : {
"airport" : {
"iataCode" : "OSL",
"cityText" : "Oslo"
},
"scheduled" : "2020-01-22T16:00:00+01:00",
"estimated" : "2020-01-22T16:03:00+01:00",
"status" : "AR",
"statusText" : "Arrived",
"terminal" : "2",
"gate" : "A4",
"carousel" : "9",
"gateSlots" : [ {
"externalName" : "A4"
} ]
},
"serviceType" : "J"
}, {
"flightIdentifier" : {
"operatingCarrier" : {
"iataCode" : "KL",
"flightNumber" : "1146",
"name" : "KLM Royal Dutch Airlines"
},
"marketingCarriers" : [ {
"iataCode" : "DL",
"flightNumber" : "9598",
"name" : "Delta Air Lines"
} ],
"aircraft" : {
"iataCode" : "EMJ",
"registration" : "PHEZH"
}
},
"arrival" : {
"airport" : {
"iataCode" : "OSL",
"cityText" : "Oslo"
},
"scheduled" : "2020-01-22T16:00:00+01:00",
"estimated" : "2020-01-22T16:03:00+01:00",
"actual" : "2020-01-22T16:03:00+01:00",
"status" : "AR",
"statusText" : "Arrived",
"terminal" : "2",
"gate" : "A4",
"carousel" : "9",
"gateSlots" : [ {
"externalName" : "A4"
} ]
},
"serviceType" : "J"
}, {
"flightIdentifier" : {
"operatingCarrier" : {
"iataCode" : "KL",
"flightNumber" : "1386",
"name" : "KLM Royal Dutch Airlines"
},
"aircraft" : {
"iataCode" : "73H",
"registration" : "PHHSE"
}
},
"arrival" : {
"airport" : {
"iataCode" : "KBP",
"cityText" : "Kiev"
},
"scheduled" : "2020-01-22T16:00:00+01:00",
"status" : "AR",
"statusText" : "Arrived",
"terminal" : "3",
"gate" : "A9",
"carousel" : "17",
"gateSlots" : [ {
"externalName" : "A9"
} ]
},
"serviceType" : "J"
}, {
"flightIdentifier" : {
"operatingCarrier" : {
"iataCode" : "KL",
"flightNumber" : "1386",
"name" : "KLM Royal Dutch Airlines"
},
"aircraft" : {
"iataCode" : "73H",
"registration" : "PHHSE"
}
},
"arrival" : {
"airport" : {
"iataCode" : "KBP",
"cityText" : "Kiev"
},
"scheduled" : "2020-01-22T16:00:00+01:00",
"estimated" : "2020-01-22T15:44:00+01:00",
"status" : "AR",
"statusText" : "Arrived",
"terminal" : "3",
"gate" : "A9",
"carousel" : "17",
"gateSlots" : [ {
"externalName" : "A9"
} ]
},
"serviceType" : "J"
}, {
"flightIdentifier" : {
"operatingCarrier" : {
"iataCode" : "KL",
"flightNumber" : "1386",
"name" : "KLM Royal Dutch Airlines"
},
"aircraft" : {
"iataCode" : "73H",
"registration" : "PHHSE"
}
},
"arrival" : {
"airport" : {
"iataCode" : "KBP",
"cityText" : "Kiev"
},
"scheduled" : "2020-01-22T16:00:00+01:00",
"estimated" : "2020-01-22T15:44:00+01:00",
"actual" : "2020-01-22T15:44:00+01:00",
"status" : "AR",
"statusText" : "Arrived",
"terminal" : "3",
"gate" : "A9",
"carousel" : "17",
"gateSlots" : [ {
"externalName" : "A9"
} ]
},
"serviceType" : "J"
}, {
"flightIdentifier" : {
"operatingCarrier" : {
"iataCode" : "KL",
"flightNumber" : "1386",
"name" : "KLM Royal Dutch Airlines"
},
"marketingCarriers" : [ {
"iataCode" : "DL",
"flightNumber" : "9473",
"name" : "Delta Air Lines"
}, {
"iataCode" : "PS",
"flightNumber" : "9386",
"name" : "Ukraine International Airlines"
} ],
"aircraft" : {
"iataCode" : "73H",
"registration" : "PHHSE"
}
},
"arrival" : {
"airport" : {
"iataCode" : "KBP",
"cityText" : "Kiev"
},
"scheduled" : "2020-01-22T16:00:00+01:00",
"estimated" : "2020-01-22T15:44:00+01:00",
"actual" : "2020-01-22T15:44:00+01:00",
"status" : "AR",
"statusText" : "Arrived",
"terminal" : "3",
"gate" : "A9",
"carousel" : "17",
"gateSlots" : [ {
"externalName" : "A9"
} ]
},
"serviceType" : "J"
} ]
}
2.2.1.7 GET Get Flight Updates
Retrieve all updates created within the from/to search window.
Payload elements are filtered based on permissions associated with the 'x-apikey' used in the request.
Query parameters
Parameter | Description |
---|---|
| Date interval start e.g 2020-01-01T12:00:00-0000. Default is current UTC date/time - 2 minutes |
| Date interval end e.g 2020-01-01T12:05:00-0000. Default is current UTC date/time - 1 minutes |
| Show updated fields |
| Group marketing and operating carrier flights into a single record. Default value is false |
| Group updates in a single record |
| Show additional information such as version |
| Include cargo flights. Default value is false |
Request headers
Name | Optional | Description |
---|---|---|
Content-Type | false | Content type of this request. Required value is 'application/json' |
Authorization | false | Authorization header that contains the access token. |
Response fields
Path | Type | Description |
---|---|---|
|
| Flight Records |
|
| Arrival |
|
| The actual local departure/arrival time for this flight e.g 2020-01-22T12:00:00+03:00 |
|
| Airport |
|
| The city in which the airport is located e.g New York |
|
| The city in which the airport is located e.g New York |
|
| 3-character airport IATA code e.g JFK |
|
| 4-character airport ICAO code e.g KJFK |
|
| The name of the airport e.g John F Kennedy International Airport |
|
| Expected carousel(s) for baggage reclaim |
|
| Carousel Slots |
|
| Location details of the slot resource i.e check-in desks1-20, Gate 2C etc |
|
| End time for the slot activity e.g check-in desk closed |
|
| Name used to identify the slot |
|
| Name used to identify the slot internally |
|
| Start time for the slot activity e.g check-in desk opened |
|
| Check-in desk details e.g CK-1 |
|
| Checkin Slots |
|
| Location details of the slot resource i.e check-in desks1-20, Gate 2C etc |
|
| End time for the slot activity e.g check-in desk closed |
|
| Name used to identify the slot |
|
| Name used to identify the slot internally |
|
| Start time for the slot activity e.g check-in desk opened |
|
| Baggage chute details e.g CH-2 |
|
| Chute Slots |
|
| Location details of the slot resource i.e check-in desks1-20, Gate 2C etc |
|
| End time for the slot activity e.g check-in desk closed |
|
| Name used to identify the slot |
|
| Name used to identify the slot internally |
|
| Start time for the slot activity e.g check-in desk opened |
|
| Custom Properties |
|
| Key value used to identify a custom property |
|
| The value of a custom property |
|
| Flight Diversion Details. |
|
| Flight Diversion original record |
|
| Airport |
|
| The city in which the airport is located e.g New York |
|
| The city in which the airport is located e.g New York |
|
| 3-character airport IATA code e.g JFK |
|
| 4-character airport ICAO code e.g KJFK |
|
| The name of the airport e.g John F Kennedy International Airport |
|
| Diversion flight original flight number |
|
| Diversion flight original airline iata code |
|
| Diversion flight original airline icao code |
|
| Diversion flight original airline name |
|
| Diversion flight original scheduled date of operation |
|
| Flight Diversion recovery record |
|
| Airport |
|
| The city in which the airport is located e.g New York |
|
| The city in which the airport is located e.g New York |
|
| 3-character airport IATA code e.g JFK |
|
| 4-character airport ICAO code e.g KJFK |
|
| The name of the airport e.g John F Kennedy International Airport |
|
| Diversion flight recovery flight number |
|
| Diversion flight recovery airline iata code |
|
| Diversion flight recovery airline icao code |
|
| Diversion flight recovery airline name |
|
| Diversion flight recovery scheduled date of operation |
|
| The latest estimated local departure/arrival time for this flight e.g 2020-01-22T12:00:00+03:00 |
|
| Flight events. |
|
| The actual local time at which the aircraft arrived at the gate |
|
| The actual local time at which the aircraft landed on the runway |
|
| The actual local time at which the aircraft left the gate |
|
| The actual local time at which the aircraft left the runway |
|
| The estimated local time at which the aircraft is expected at the gate |
|
| The estimated local time at which the aircraft is expected to land on the runway |
|
| The estimated local time at which the aircraft is expected to leave the gate |
|
| The estimated local time at which the aircraft is expected to leave the runway |
|
| The local time at which the aircraft is targeted to leave the gate |
|
| The local time at which the aircraft is targeted to leave the runway |
|
| The flights departure/arrival gate e.g C1 |
|
| Arrival gate remark |
|
| Gate remark text when applicable e.g Boarding at 21:00 |
|
| Gate Slots |
|
| Location details of the slot resource i.e check-in desks1-20, Gate 2C etc |
|
| End time for the slot activity e.g check-in desk closed |
|
| Name used to identify the slot |
|
| Name used to identify the slot internally |
|
| Start time for the slot activity e.g check-in desk opened |
|
| Route |
|
| 3-character airport IATA code |
|
| 4-character airport ICAO code |
|
| Value used to identify the routes position within an entire flight route e.g leg 0, leg 1, leg 2 etc |
|
| The published scheduled local departure/arrival time for this flight e.g 2020-01-22T12:00:00+03:00 |
|
| Aircraft stand details e.g S12 |
|
| Stand Slots |
|
| Location details of the slot resource i.e check-in desks1-20, Gate 2C etc |
|
| End time for the slot activity e.g check-in desk closed |
|
| Name used to identify the slot |
|
| Name used to identify the slot internally |
|
| Start time for the slot activity e.g check-in desk opened |
|
| The current status code for this flight e.g SC, DP |
|
| The current status text for this flight e.g Scheduled, Departed |
|
| The flights departure/arrival terminal e.g T1 |
|
| Updates |
|
| Current field value |
|
| UTC timestamp when update was applied (only visible when updates are grouped) |
|
| Data source of this update (only visible when updates are grouped) |
|
| Previous field value |
|
| UTC timestamp when update was received |
|
| Payload field which was updated |
|
| FLIFO internal version number |
|
| Departure |
|
| The actual local departure/arrival time for this flight e.g 2020-01-22T12:00:00+03:00 |
|
| Airport |
|
| The city in which the airport is located e.g New York |
|
| The city in which the airport is located e.g New York |
|
| 3-character airport IATA code e.g JFK |
|
| 4-character airport ICAO code e.g KJFK |
|
| The name of the airport e.g John F Kennedy International Airport |
|
| Expected carousel(s) for baggage reclaim |
|
| Carousel Slots |
|
| Location details of the slot resource i.e check-in desks1-20, Gate 2C etc |
|
| End time for the slot activity e.g check-in desk closed |
|
| Name used to identify the slot |
|
| Name used to identify the slot internally |
|
| Start time for the slot activity e.g check-in desk opened |
|
| Check-in desk details e.g CK-1 |
|
| Checkin Slots |
|
| Location details of the slot resource i.e check-in desks1-20, Gate 2C etc |
|
| End time for the slot activity e.g check-in desk closed |
|
| Name used to identify the slot |
|
| Name used to identify the slot internally |
|
| Start time for the slot activity e.g check-in desk opened |
|
| Baggage chute details e.g CH-2 |
|
| Chute Slots |
|
| Location details of the slot resource i.e check-in desks1-20, Gate 2C etc |
|
| End time for the slot activity e.g check-in desk closed |
|
| Name used to identify the slot |
|
| Name used to identify the slot internally |
|
| Start time for the slot activity e.g check-in desk opened |
|
| Custom Properties |
|
| Key value used to identify a custom property |
|
| The value of a custom property |
|
| Flight Diversion Details. |
|
| Flight Diversion original record |
|
| Airport |
|
| The city in which the airport is located e.g New York |
|
| The city in which the airport is located e.g New York |
|
| 3-character airport IATA code e.g JFK |
|
| 4-character airport ICAO code e.g KJFK |
|
| The name of the airport e.g John F Kennedy International Airport |
|
| Diversion flight original flight number |
|
| Diversion flight original airline iata code |
|
| Diversion flight original airline icao code |
|
| Diversion flight original airline name |
|
| Diversion flight original scheduled date of operation |
|
| Flight Diversion recovery record |
|
| Airport |
|
| The city in which the airport is located e.g New York |
|
| The city in which the airport is located e.g New York |
|
| 3-character airport IATA code e.g JFK |
|
| 4-character airport ICAO code e.g KJFK |
|
| The name of the airport e.g John F Kennedy International Airport |
|
| Diversion flight recovery flight number |
|
| Diversion flight recovery airline iata code |
|
| Diversion flight recovery airline icao code |
|
| Diversion flight recovery airline name |
|
| Diversion flight recovery scheduled date of operation |
|
| The latest estimated local departure/arrival time for this flight e.g 2020-01-22T12:00:00+03:00 |
|
| Flight events. |
|
| The actual local time at which the aircraft arrived at the gate |
|
| The actual local time at which the aircraft landed on the runway |
|
| The actual local time at which the aircraft left the gate |
|
| The actual local time at which the aircraft left the runway |
|
| The estimated local time at which the aircraft is expected at the gate |
|
| The estimated local time at which the aircraft is expected to land on the runway |
|
| The estimated local time at which the aircraft is expected to leave the gate |
|
| The estimated local time at which the aircraft is expected to leave the runway |
|
| The local time at which the aircraft is targeted to leave the gate |
|
| The local time at which the aircraft is targeted to leave the runway |
|
| The flights departure/arrival gate e.g C1 |
|
| Departure gate remark |
|
| Gate remark text when applicable e.g Boarding at 21:00 |
|
| Gate Slots |
|
| Location details of the slot resource i.e check-in desks1-20, Gate 2C etc |
|
| End time for the slot activity e.g check-in desk closed |
|
| Name used to identify the slot |
|
| Name used to identify the slot internally |
|
| Start time for the slot activity e.g check-in desk opened |
|
| Route |
|
| 3-character airport IATA code |
|
| 4-character airport ICAO code |
|
| Value used to identify the routes position within an entire flight route e.g leg 0, leg 1, leg 2 etc |
|
| The published scheduled local departure/arrival time for this flight e.g 2020-01-22T12:00:00+03:00 |
|
| Aircraft stand details e.g S12 |
|
| Stand Slots |
|
| Location details of the slot resource i.e check-in desks1-20, Gate 2C etc |
|
| End time for the slot activity e.g check-in desk closed |
|
| Name used to identify the slot |
|
| Name used to identify the slot internally |
|
| Start time for the slot activity e.g check-in desk opened |
|
| The current status code for this flight e.g SC, DP |
|
| The current status text for this flight e.g Scheduled, Departed |
|
| The flights departure/arrival terminal e.g T1 |
|
| Updates |
|
| Current field value |
|
| UTC timestamp when update was applied (only visible when updates are grouped) |
|
| Data source of this update (only visible when updates are grouped) |
|
| Previous field value |
|
| UTC timestamp when update was received |
|
| Payload field which was updated |
|
| FLIFO internal version number |
|
| Flight duration in minutes e.g 60 |
|
| Flight Identifier |
|
| Aircraft |
|
| Callsign for the aircraft type |
|
| IATA code for the aircraft |
|
| ICAO code for the aircraft |
|
| Specific aircraft model details |
|
| Aircraft regristration/tail number details e.g EIAA44W |
|
| A value that uniquely identifies a flight within the system |
|
| Marketing Carriers |
|
| Flight number e.g 1234 |
|
| 2-character airline IATA code e.g AA |
|
| 3-character airline ICAO code e.g AAL |
|
| Name of airline e.g American Airlines |
|
| Operating Carrier |
|
| Flight number e.g 1234 |
|
| 2-character airline IATA code e.g A |
|
| 3-character airline ICAO code e.g AAL |
|
| Name of airline e.g American Airlines |
|
| Flight Stats |
|
| Baggage |
|
| Total number of cargo pieces |
|
| Total number of bags/pieces |
|
| Load breakdown |
|
| Total number of mail pieces |
|
| Total weight of bags/pieces |
|
| Passengers |
|
| Actual number of business class passengers |
|
| Actual number of economy class passengers |
|
| Actual number of 1st class passengers |
|
| Actual number of passengers |
|
| Actual number of transfer passengers |
|
| Actual number of transit passengers |
|
| Total number of adults |
|
| Total number of booked business class passengers |
|
| Total number of booked economy class passengers |
|
| Total number of booked 1st class passengers |
|
| Total number of booked passengers |
|
| Total number of children |
|
| Total number of infants |
|
| Total number of reduced mobility passengers e.g those requiring assistance boarding the aircraft etc. |
|
| UTC timestamp when update was applied |
|
| Data source of this update |
|
| Flight service type e.g J-Passenger, F-Cargo |
|
| Group Marketing Carriers |
|
| Group Updates |
|
| Include Updates |
|
| Interval |
|
| From |
|
| Serial Version UID |
|
| To |
|
| Serial Version UID |
|
| Matched Records |
|
| Session Id |
|
| $ assertions Disabled |
|
| Least Sig Bits |
|
| Most Sig Bits |
|
| Serial Version UID |
Curl request
$ curl 'https://flifo.api.aero/flifo/flightinfo/v2/flights/updates?from=2020-01-22T12:00:00.000Z&to=2020-01-22T13:00:00.000Z' -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: 18268
{
"sessionId" : "df1e6233-3534-430f-9f01-db8d4d85f856",
"interval" : {
"from" : "2020-01-22T10:00:00+00:00",
"to" : "2020-01-22T11:00:00+00:00"
},
"includeUpdates" : false,
"groupUpdates" : false,
"groupMarketingCarriers" : true,
"matchedRecords" : 22,
"flightRecords" : [ {
"flightIdentifier" : {
"operatingCarrier" : {
"iataCode" : "KL",
"flightNumber" : "1417",
"name" : "KLM Royal Dutch Airlines"
},
"aircraft" : {
"iataCode" : "73H",
"registration" : "PHBCD"
}
},
"departure" : {
"airport" : {
"iataCode" : "LYS",
"cityText" : "Lyon"
},
"scheduled" : "2020-01-22T16:00:00+01:00",
"status" : "SC",
"statusText" : "Scheduled",
"terminal" : "1",
"gate" : "C10",
"gateSlots" : [ {
"externalName" : "C10"
} ]
},
"serviceType" : "J",
"duration" : "240"
}, {
"flightIdentifier" : {
"operatingCarrier" : {
"iataCode" : "KL",
"flightNumber" : "1146",
"name" : "KLM Royal Dutch Airlines"
},
"marketingCarriers" : [ {
"iataCode" : "DL",
"flightNumber" : "9598",
"name" : "Delta Air Lines"
} ],
"aircraft" : {
"iataCode" : "EMJ",
"registration" : "PHEZH"
}
},
"arrival" : {
"airport" : {
"iataCode" : "OSL",
"cityText" : "Oslo"
},
"scheduled" : "2020-01-22T16:00:00+01:00",
"status" : "SC",
"statusText" : "Scheduled",
"terminal" : "2",
"gate" : "A4",
"carousel" : "9",
"gateSlots" : [ {
"externalName" : "A4"
} ]
},
"serviceType" : "J"
}, {
"flightIdentifier" : {
"operatingCarrier" : {
"iataCode" : "KL",
"flightNumber" : "937",
"name" : "KLM Royal Dutch Airlines"
},
"marketingCarriers" : [ {
"iataCode" : "DL",
"flightNumber" : "9428",
"name" : "Delta Air Lines"
} ],
"aircraft" : {
"iataCode" : "EMJ",
"registration" : "EIGGB"
}
},
"departure" : {
"airport" : {
"iataCode" : "DUB",
"cityText" : "Dublin"
},
"scheduled" : "2020-01-22T16:00:00+01:00",
"status" : "SC",
"statusText" : "Scheduled",
"terminal" : "2",
"gate" : "D6",
"gateSlots" : [ {
"externalName" : "D6"
} ]
},
"serviceType" : "J",
"duration" : "300"
}, {
"flightIdentifier" : {
"operatingCarrier" : {
"iataCode" : "KL",
"flightNumber" : "1394",
"name" : "KLM Royal Dutch Airlines"
},
"aircraft" : {
"iataCode" : "73H",
"registration" : "PHBXG"
}
},
"arrival" : {
"airport" : {
"iataCode" : "LED",
"cityText" : "St. Petersburg"
},
"scheduled" : "2020-01-22T16:00:00+01:00",
"status" : "SC",
"statusText" : "Scheduled",
"terminal" : "3",
"gate" : "A9",
"carousel" : "15",
"gateSlots" : [ {
"externalName" : "A9"
} ]
},
"serviceType" : "J"
}, {
"flightIdentifier" : {
"operatingCarrier" : {
"iataCode" : "KL",
"flightNumber" : "1386",
"name" : "KLM Royal Dutch Airlines"
},
"aircraft" : {
"iataCode" : "73H",
"registration" : "PHHSE"
}
},
"arrival" : {
"airport" : {
"iataCode" : "KBP",
"cityText" : "Kiev"
},
"scheduled" : "2020-01-22T16:00:00+01:00",
"status" : "SC",
"statusText" : "Scheduled",
"terminal" : "3",
"gate" : "A9",
"carousel" : "17",
"gateSlots" : [ {
"externalName" : "A9"
} ]
},
"serviceType" : "J"
}, {
"flightIdentifier" : {
"operatingCarrier" : {
"iataCode" : "KL",
"flightNumber" : "1417",
"name" : "KLM Royal Dutch Airlines"
},
"aircraft" : {
"iataCode" : "73H",
"registration" : "PHBCD"
}
},
"departure" : {
"airport" : {
"iataCode" : "LYS",
"cityText" : "Lyon"
},
"scheduled" : "2020-01-22T16:00:00+01:00",
"status" : "DP",
"statusText" : "Departed",
"terminal" : "1",
"gate" : "C10",
"gateSlots" : [ {
"externalName" : "C10"
} ]
},
"serviceType" : "J",
"duration" : "240"
}, {
"flightIdentifier" : {
"operatingCarrier" : {
"iataCode" : "KL",
"flightNumber" : "1417",
"name" : "KLM Royal Dutch Airlines"
},
"aircraft" : {
"iataCode" : "73H",
"registration" : "PHBCD"
}
},
"departure" : {
"airport" : {
"iataCode" : "LYS",
"cityText" : "Lyon"
},
"scheduled" : "2020-01-22T16:00:00+01:00",
"actual" : "2020-01-22T16:15:00+01:00",
"status" : "DP",
"statusText" : "Departed",
"terminal" : "1",
"gate" : "C10",
"gateSlots" : [ {
"externalName" : "C10"
} ]
},
"serviceType" : "J",
"duration" : "240"
}, {
"flightIdentifier" : {
"operatingCarrier" : {
"iataCode" : "KL",
"flightNumber" : "1417",
"name" : "KLM Royal Dutch Airlines"
},
"marketingCarriers" : [ {
"iataCode" : "AF",
"flightNumber" : "8291",
"name" : "Air France"
}, {
"iataCode" : "DL",
"flightNumber" : "9515",
"name" : "Delta Air Lines"
}, {
"iataCode" : "G3",
"flightNumber" : "5609",
"name" : "Sky Express"
} ],
"aircraft" : {
"iataCode" : "73H",
"registration" : "PHBCD"
}
},
"departure" : {
"airport" : {
"iataCode" : "LYS",
"cityText" : "Lyon"
},
"scheduled" : "2020-01-22T16:00:00+01:00",
"actual" : "2020-01-22T16:15:00+01:00",
"status" : "DP",
"statusText" : "Departed",
"terminal" : "1",
"gate" : "C10",
"gateSlots" : [ {
"externalName" : "C10"
} ]
},
"serviceType" : "J",
"duration" : "240"
}, {
"flightIdentifier" : {
"operatingCarrier" : {
"iataCode" : "KL",
"flightNumber" : "1394",
"name" : "KLM Royal Dutch Airlines"
},
"aircraft" : {
"iataCode" : "73H",
"registration" : "PHBXG"
}
},
"arrival" : {
"airport" : {
"iataCode" : "LED",
"cityText" : "St. Petersburg"
},
"scheduled" : "2020-01-22T16:00:00+01:00",
"status" : "AR",
"statusText" : "Arrived",
"terminal" : "3",
"gate" : "A9",
"carousel" : "15",
"gateSlots" : [ {
"externalName" : "A9"
} ]
},
"serviceType" : "J"
}, {
"flightIdentifier" : {
"operatingCarrier" : {
"iataCode" : "KL",
"flightNumber" : "1394",
"name" : "KLM Royal Dutch Airlines"
},
"aircraft" : {
"iataCode" : "73H",
"registration" : "PHBXG"
}
},
"arrival" : {
"airport" : {
"iataCode" : "LED",
"cityText" : "St. Petersburg"
},
"scheduled" : "2020-01-22T16:00:00+01:00",
"estimated" : "2020-01-22T15:47:00+01:00",
"status" : "AR",
"statusText" : "Arrived",
"terminal" : "3",
"gate" : "A9",
"carousel" : "15",
"gateSlots" : [ {
"externalName" : "A9"
} ]
},
"serviceType" : "J"
}, {
"flightIdentifier" : {
"operatingCarrier" : {
"iataCode" : "KL",
"flightNumber" : "1394",
"name" : "KLM Royal Dutch Airlines"
},
"aircraft" : {
"iataCode" : "73H",
"registration" : "PHBXG"
}
},
"arrival" : {
"airport" : {
"iataCode" : "LED",
"cityText" : "St. Petersburg"
},
"scheduled" : "2020-01-22T16:00:00+01:00",
"estimated" : "2020-01-22T15:47:00+01:00",
"actual" : "2020-01-22T15:47:00+01:00",
"status" : "AR",
"statusText" : "Arrived",
"terminal" : "3",
"gate" : "A9",
"carousel" : "15",
"gateSlots" : [ {
"externalName" : "A9"
} ]
},
"serviceType" : "J"
}, {
"flightIdentifier" : {
"operatingCarrier" : {
"iataCode" : "KL",
"flightNumber" : "1394",
"name" : "KLM Royal Dutch Airlines"
},
"marketingCarriers" : [ {
"iataCode" : "DL",
"flightNumber" : "8204",
"name" : "Delta Air Lines"
}, {
"iataCode" : "KQ",
"flightNumber" : "1394",
"name" : "Kenya Airways"
}, {
"iataCode" : "SU",
"flightNumber" : "3410",
"name" : "Aeroflot Russian Airlines"
} ],
"aircraft" : {
"iataCode" : "73H",
"registration" : "PHBXG"
}
},
"arrival" : {
"airport" : {
"iataCode" : "LED",
"cityText" : "St. Petersburg"
},
"scheduled" : "2020-01-22T16:00:00+01:00",
"estimated" : "2020-01-22T15:47:00+01:00",
"actual" : "2020-01-22T15:47:00+01:00",
"status" : "AR",
"statusText" : "Arrived",
"terminal" : "3",
"gate" : "A9",
"carousel" : "15",
"gateSlots" : [ {
"externalName" : "A9"
} ]
},
"serviceType" : "J"
}, {
"flightIdentifier" : {
"operatingCarrier" : {
"iataCode" : "KL",
"flightNumber" : "937",
"name" : "KLM Royal Dutch Airlines"
},
"marketingCarriers" : [ {
"iataCode" : "DL",
"flightNumber" : "9428",
"name" : "Delta Air Lines"
} ],
"aircraft" : {
"iataCode" : "EMJ",
"registration" : "EIGGB"
}
},
"departure" : {
"airport" : {
"iataCode" : "DUB",
"cityText" : "Dublin"
},
"scheduled" : "2020-01-22T16:00:00+01:00",
"status" : "DP",
"statusText" : "Departed",
"terminal" : "2",
"gate" : "D6",
"gateSlots" : [ {
"externalName" : "D6"
} ]
},
"serviceType" : "J",
"duration" : "300"
}, {
"flightIdentifier" : {
"operatingCarrier" : {
"iataCode" : "KL",
"flightNumber" : "937",
"name" : "KLM Royal Dutch Airlines"
},
"marketingCarriers" : [ {
"iataCode" : "DL",
"flightNumber" : "9428",
"name" : "Delta Air Lines"
} ],
"aircraft" : {
"iataCode" : "EMJ",
"registration" : "EIGGB"
}
},
"departure" : {
"airport" : {
"iataCode" : "DUB",
"cityText" : "Dublin"
},
"scheduled" : "2020-01-22T16:00:00+01:00",
"actual" : "2020-01-22T16:17:00+01:00",
"status" : "DP",
"statusText" : "Departed",
"terminal" : "2",
"gate" : "D6",
"gateSlots" : [ {
"externalName" : "D6"
} ]
},
"serviceType" : "J",
"duration" : "300"
}, {
"flightIdentifier" : {
"operatingCarrier" : {
"iataCode" : "KL",
"flightNumber" : "937",
"name" : "KLM Royal Dutch Airlines"
},
"marketingCarriers" : [ {
"iataCode" : "DL",
"flightNumber" : "9428",
"name" : "Delta Air Lines"
}, {
"iataCode" : "MF",
"flightNumber" : "9997",
"name" : "Xiamen Airlines"
} ],
"aircraft" : {
"iataCode" : "EMJ",
"registration" : "EIGGB"
}
},
"departure" : {
"airport" : {
"iataCode" : "DUB",
"cityText" : "Dublin"
},
"scheduled" : "2020-01-22T16:00:00+01:00",
"actual" : "2020-01-22T16:17:00+01:00",
"status" : "DP",
"statusText" : "Departed",
"terminal" : "2",
"gate" : "D6",
"gateSlots" : [ {
"externalName" : "D6"
} ]
},
"serviceType" : "J",
"duration" : "300"
}, {
"flightIdentifier" : {
"operatingCarrier" : {
"iataCode" : "KL",
"flightNumber" : "1146",
"name" : "KLM Royal Dutch Airlines"
},
"marketingCarriers" : [ {
"iataCode" : "DL",
"flightNumber" : "9598",
"name" : "Delta Air Lines"
} ],
"aircraft" : {
"iataCode" : "EMJ",
"registration" : "PHEZH"
}
},
"arrival" : {
"airport" : {
"iataCode" : "OSL",
"cityText" : "Oslo"
},
"scheduled" : "2020-01-22T16:00:00+01:00",
"status" : "AR",
"statusText" : "Arrived",
"terminal" : "2",
"gate" : "A4",
"carousel" : "9",
"gateSlots" : [ {
"externalName" : "A4"
} ]
},
"serviceType" : "J"
}, {
"flightIdentifier" : {
"operatingCarrier" : {
"iataCode" : "KL",
"flightNumber" : "1146",
"name" : "KLM Royal Dutch Airlines"
},
"marketingCarriers" : [ {
"iataCode" : "DL",
"flightNumber" : "9598",
"name" : "Delta Air Lines"
} ],
"aircraft" : {
"iataCode" : "EMJ",
"registration" : "PHEZH"
}
},
"arrival" : {
"airport" : {
"iataCode" : "OSL",
"cityText" : "Oslo"
},
"scheduled" : "2020-01-22T16:00:00+01:00",
"estimated" : "2020-01-22T16:03:00+01:00",
"status" : "AR",
"statusText" : "Arrived",
"terminal" : "2",
"gate" : "A4",
"carousel" : "9",
"gateSlots" : [ {
"externalName" : "A4"
} ]
},
"serviceType" : "J"
}, {
"flightIdentifier" : {
"operatingCarrier" : {
"iataCode" : "KL",
"flightNumber" : "1146",
"name" : "KLM Royal Dutch Airlines"
},
"marketingCarriers" : [ {
"iataCode" : "DL",
"flightNumber" : "9598",
"name" : "Delta Air Lines"
} ],
"aircraft" : {
"iataCode" : "EMJ",
"registration" : "PHEZH"
}
},
"arrival" : {
"airport" : {
"iataCode" : "OSL",
"cityText" : "Oslo"
},
"scheduled" : "2020-01-22T16:00:00+01:00",
"estimated" : "2020-01-22T16:03:00+01:00",
"actual" : "2020-01-22T16:03:00+01:00",
"status" : "AR",
"statusText" : "Arrived",
"terminal" : "2",
"gate" : "A4",
"carousel" : "9",
"gateSlots" : [ {
"externalName" : "A4"
} ]
},
"serviceType" : "J"
}, {
"flightIdentifier" : {
"operatingCarrier" : {
"iataCode" : "KL",
"flightNumber" : "1386",
"name" : "KLM Royal Dutch Airlines"
},
"aircraft" : {
"iataCode" : "73H",
"registration" : "PHHSE"
}
},
"arrival" : {
"airport" : {
"iataCode" : "KBP",
"cityText" : "Kiev"
},
"scheduled" : "2020-01-22T16:00:00+01:00",
"status" : "AR",
"statusText" : "Arrived",
"terminal" : "3",
"gate" : "A9",
"carousel" : "17",
"gateSlots" : [ {
"externalName" : "A9"
} ]
},
"serviceType" : "J"
}, {
"flightIdentifier" : {
"operatingCarrier" : {
"iataCode" : "KL",
"flightNumber" : "1386",
"name" : "KLM Royal Dutch Airlines"
},
"aircraft" : {
"iataCode" : "73H",
"registration" : "PHHSE"
}
},
"arrival" : {
"airport" : {
"iataCode" : "KBP",
"cityText" : "Kiev"
},
"scheduled" : "2020-01-22T16:00:00+01:00",
"estimated" : "2020-01-22T15:44:00+01:00",
"status" : "AR",
"statusText" : "Arrived",
"terminal" : "3",
"gate" : "A9",
"carousel" : "17",
"gateSlots" : [ {
"externalName" : "A9"
} ]
},
"serviceType" : "J"
}, {
"flightIdentifier" : {
"operatingCarrier" : {
"iataCode" : "KL",
"flightNumber" : "1386",
"name" : "KLM Royal Dutch Airlines"
},
"aircraft" : {
"iataCode" : "73H",
"registration" : "PHHSE"
}
},
"arrival" : {
"airport" : {
"iataCode" : "KBP",
"cityText" : "Kiev"
},
"scheduled" : "2020-01-22T16:00:00+01:00",
"estimated" : "2020-01-22T15:44:00+01:00",
"actual" : "2020-01-22T15:44:00+01:00",
"status" : "AR",
"statusText" : "Arrived",
"terminal" : "3",
"gate" : "A9",
"carousel" : "17",
"gateSlots" : [ {
"externalName" : "A9"
} ]
},
"serviceType" : "J"
}, {
"flightIdentifier" : {
"operatingCarrier" : {
"iataCode" : "KL",
"flightNumber" : "1386",
"name" : "KLM Royal Dutch Airlines"
},
"marketingCarriers" : [ {
"iataCode" : "DL",
"flightNumber" : "9473",
"name" : "Delta Air Lines"
}, {
"iataCode" : "PS",
"flightNumber" : "9386",
"name" : "Ukraine International Airlines"
} ],
"aircraft" : {
"iataCode" : "73H",
"registration" : "PHHSE"
}
},
"arrival" : {
"airport" : {
"iataCode" : "KBP",
"cityText" : "Kiev"
},
"scheduled" : "2020-01-22T16:00:00+01:00",
"estimated" : "2020-01-22T15:44:00+01:00",
"actual" : "2020-01-22T15:44:00+01:00",
"status" : "AR",
"statusText" : "Arrived",
"terminal" : "3",
"gate" : "A9",
"carousel" : "17",
"gateSlots" : [ {
"externalName" : "A9"
} ]
},
"serviceType" : "J"
} ]
}
2.3 Notes
2.3.1 'view' parameter
'view' parameter
The 'view' query parameter can have the value 'local' or 'full' (default value is 'local').
The purpose of this parameter is to enable the user to decide if they wish to see just the 'local' view of the flight (e.g only the
departure details if 'direction' parameter provided was 'D') or the 'full' view which will return both departure and arrival details for the flight(s) if 'direction' parameter provided was 'D'.
flifo/flightinfo/v2/flights/airport/JFK/airline/B6/direction/D?view=local | flifo/flightinfo/v2/flights/airport/JFK/airline/B6/direction/D?view=full |
---|---|
|
|
3 SeamlessTravel
3.1 Introduction
The SeamlessTravel resources provides users with the ability to search for flights based on a) airport and direction or b) individual flight details
Response payloads conform to the ACRIS SeamlessTravel specification. More details can be found at https://acris.aero/
3.1.1 Registration and API Sign Up
To access the APIs you will need a registration key, also known as 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.
3.1.2 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/flifo/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...
3.1.3 Security
- All incoming requests will be REST over HTTPS.
- Users are authenticated using their API key.
- Certain response payload elements will be filtered based on permissions associated with the x-apikey value used.
- The API key used in the REST call will be included in the response headers returned to the end user.
3.1.4 Error Response
Response fields
Path | Type | Description |
---|---|---|
|
| Object that holds the error information |
|
| Array of errors |
|
| 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.1.5 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 |
4 Resources
This section describes the SeamlessTravel/ACRIS 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.2.1 GET Get Flight by Airline, Flight Number, Operation Date, Departure Airport and Arrival Airport
Path parameters
Parameter | Description |
---|---|
| 2-character airline IATA code or 3-character airline ICAO code |
| Flight number |
| Local date of operation (yyyy-MM-dd) |
| 3-character airport IATA code or 4-character airport ICAO code |
| 3-character airport IATA code or 4-character airport ICAO code |
Query parameters
Parameter | Description |
---|---|
| Flight suffix (4A, 123B) |
Request headers
Name | Optional | Description |
---|---|---|
Content-Type | false | Content type of this request. Required value is 'application/json' |
Authorization | false | Authorization header that contains the access token. |
Response fields
Path | Type | Description |
---|---|---|
|
| Aircraft Type |
|
| ICAO code for the aircraft |
|
| Specific aircraft model details |
|
| Aircraft regristration/tail number details e.g EIAA44W |
|
| Arrival |
|
| Actual flight arrival date/time (ISO-8601 format) |
|
| Baggage Claim |
|
| The carousel for baggage claim e.g Belt 12 |
|
| Expected time when the baggage claim begins (ISO-8601 format) |
|
| Latest estimated flight arrival date/time (ISO-8601 format) |
|
| Arrival flight gate e.g G2 |
|
| Scheduled flight arrival date/time (ISO-8601 format) |
|
| Arrival flight terminal e.g T1 |
|
| Transfer information for arriving passengers |
|
| 3-character arrival airport IATA code e.g LAX |
|
| Code Shares |
|
| 2-character airline IATA code e.g AA |
|
| Track/Flight number suffix e.g A |
|
| Track/Flight number for the flight e.g 1234 |
|
| Departure |
|
| Actual flight departure date/time (ISO-8601 format) |
|
| Boarding Time |
|
| Boarding time per travel class |
|
| Boarding date/time (ISO-8601 format) |
|
| Checkin Info |
|
| Additional information about the check-in process |
|
| The time when check-in procedure starts for the flight (ISO-8601 format) |
|
| The time when check-in procedure ends for the flight (ISO-8601 format) |
|
| The area of check-in facilities for the flight |
|
| Latest estimated flight departure date/time (ISO-8601 format) |
|
| Departure flight gate e.g G2 |
|
| Scheduled flight departure date/time (ISO-8601 format) |
|
| Departure flight terminal e.g T1 |
|
| 3-character departure airport IATA code e.g JFK |
|
| Flight Number |
|
| 2-character airline IATA code e.g AA |
|
| Track/Flight number suffix e.g A |
|
| Track/Flight number for the flight e.g 1234 |
|
| Flight Status |
|
| Time stamp of the most recent update received for this flight |
|
| Operating Airline |
|
| 2-character airline IATA code e.g AA |
|
| 3-character airline ICAO code e.g AAL |
|
| Name of airline e.g American Airlines |
|
| Scheduled flight departure date (YYYY-MM-DD) |
|
| Via |
|
| Arrival |
|
| Actual flight arrival date/time (ISO-8601 format) |
|
| Baggage Claim |
|
| The carousel for baggage claim e.g Belt 12 |
|
| Expected time when the baggage claim begins (ISO-8601 format) |
|
| Latest estimated flight arrival date/time (ISO-8601 format) |
|
| Arrival flight gate e.g G2 |
|
| Scheduled flight arrival date/time (ISO-8601 format) |
|
| Arrival flight terminal e.g T1 |
|
| Transfer information for arriving passengers |
|
| Departure |
|
| Actual flight departure date/time (ISO-8601 format) |
|
| Boarding Time |
|
| Boarding time per travel class |
|
| Boarding date/time (ISO-8601 format) |
|
| Checkin Info |
|
| Additional information about the check-in process |
|
| The time when check-in procedure starts for the flight (ISO-8601 format) |
|
| The time when check-in procedure ends for the flight (ISO-8601 format) |
|
| The area of check-in facilities for the flight |
|
| Latest estimated flight departure date/time (ISO-8601 format) |
|
| Departure flight gate e.g G2 |
|
| Scheduled flight departure date/time (ISO-8601 format) |
|
| Departure flight terminal e.g T1 |
|
| Via Airport |
Curl request
$ curl 'https://flifo.api.aero/flifo/aci-v1/flightDetails/KL/1394/2020-01-22/LED/AMS' -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: 1024
{
"operatingAirline" : {
"iataCode" : "KL",
"icaoCode" : "KLM",
"name" : "KLM Royal Dutch Airlines"
},
"aircraftType" : {
"icaoCode" : "B738",
"modelName" : "Boeing 737-800 pax",
"registration" : "PHBXG"
},
"flightNumber" : {
"airlineCode" : "KL",
"trackNumber" : "1394"
},
"codeShares" : [ {
"airlineCode" : "DL",
"trackNumber" : "8204"
}, {
"airlineCode" : "KQ",
"trackNumber" : "1394"
}, {
"airlineCode" : "SU",
"trackNumber" : "3410"
} ],
"departureAirport" : "LED",
"arrivalAirport" : "AMS",
"originDate" : "2020-01-22",
"departure" : {
"scheduled" : "2020-01-22T12:00:00+03:00",
"terminal" : "3"
},
"arrival" : {
"scheduled" : "2020-01-22T16:00:00+01:00",
"estimated" : "2020-01-22T15:47:00+01:00",
"actual" : "2020-01-22T15:47:00+01:00",
"terminal" : "3",
"gate" : "A9",
"baggageClaim" : {
"carousel" : "15"
}
},
"flightStatus" : "Landed"
}
3.2.2 GET Get Flights by Airport and Direction
Path parameters
Parameter | Description |
---|---|
| 3-character airport IATA code or 4-character airport ICAO code |
| Direction field (arrival/departure) |
Query parameters
Parameter | Description |
---|---|
| Length |
| Offset |
| Time range in hours |
| Start time |
Request headers
Name | Optional | Description |
---|---|---|
Content-Type | false | Content type of this request. Required value is 'application/json' |
Authorization | false | Authorization header that contains the access token. |
Response fields
Path | Type | Description |
---|---|---|
|
| Aircraft Type |
|
| ICAO code for the aircraft |
|
| Specific aircraft model details |
|
| Aircraft regristration/tail number details e.g EIAA44W |
|
| Arrival |
|
| Actual flight arrival date/time (ISO-8601 format) |
|
| Baggage Claim |
|
| The carousel for baggage claim e.g Belt 12 |
|
| Expected time when the baggage claim begins (ISO-8601 format) |
|
| Latest estimated flight arrival date/time (ISO-8601 format) |
|
| Arrival flight gate e.g G2 |
|
| Scheduled flight arrival date/time (ISO-8601 format) |
|
| Arrival flight terminal e.g T1 |
|
| Transfer information for arriving passengers |
|
| 3-character arrival airport IATA code e.g LAX |
|
| Code Shares |
|
| 2-character airline IATA code e.g AA |
|
| Track/Flight number suffix e.g A |
|
| Track/Flight number for the flight e.g 1234 |
|
| Departure |
|
| Actual flight departure date/time (ISO-8601 format) |
|
| Boarding Time |
|
| Boarding time per travel class |
|
| Boarding date/time (ISO-8601 format) |
|
| Checkin Info |
|
| Additional information about the check-in process |
|
| The time when check-in procedure starts for the flight (ISO-8601 format) |
|
| The time when check-in procedure ends for the flight (ISO-8601 format) |
|
| The area of check-in facilities for the flight |
|
| Latest estimated flight departure date/time (ISO-8601 format) |
|
| Departure flight gate e.g G2 |
|
| Scheduled flight departure date/time (ISO-8601 format) |
|
| Departure flight terminal e.g T1 |
|
| 3-character departure airport IATA code e.g JFK |
|
| Flight Number |
|
| 2-character airline IATA code e.g AA |
|
| Track/Flight number suffix e.g A |
|
| Track/Flight number for the flight e.g 1234 |
|
| Flight Status |
|
| Time stamp of the most recent update received for this flight |
|
| Operating Airline |
|
| 2-character airline IATA code e.g AA |
|
| 3-character airline ICAO code e.g AAL |
|
| Name of airline e.g American Airlines |
|
| Scheduled flight departure date (YYYY-MM-DD) |
|
| Via |
|
| Arrival |
|
| Actual flight arrival date/time (ISO-8601 format) |
|
| Baggage Claim |
|
| The carousel for baggage claim e.g Belt 12 |
|
| Expected time when the baggage claim begins (ISO-8601 format) |
|
| Latest estimated flight arrival date/time (ISO-8601 format) |
|
| Arrival flight gate e.g G2 |
|
| Scheduled flight arrival date/time (ISO-8601 format) |
|
| Arrival flight terminal e.g T1 |
|
| Transfer information for arriving passengers |
|
| Departure |
|
| Actual flight departure date/time (ISO-8601 format) |
|
| Boarding Time |
|
| Boarding time per travel class |
|
| Boarding date/time (ISO-8601 format) |
|
| Checkin Info |
|
| Additional information about the check-in process |
|
| The time when check-in procedure starts for the flight (ISO-8601 format) |
|
| The time when check-in procedure ends for the flight (ISO-8601 format) |
|
| The area of check-in facilities for the flight |
|
| Latest estimated flight departure date/time (ISO-8601 format) |
|
| Departure flight gate e.g G2 |
|
| Scheduled flight departure date/time (ISO-8601 format) |
|
| Departure flight terminal e.g T1 |
|
| Via Airport |
Curl request
$ curl 'https://flifo.api.aero/flifo/aci-v1/flight/AMS/arrival' -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: 3676
[ {
"operatingAirline" : {
"iataCode" : "KL",
"icaoCode" : "KLM",
"name" : "KLM Royal Dutch Airlines"
},
"aircraftType" : {
"icaoCode" : "EMJ",
"modelName" : "Embraer 170/190",
"registration" : "PHEZH"
},
"flightNumber" : {
"airlineCode" : "KL",
"trackNumber" : "1146"
},
"codeShares" : [ {
"airlineCode" : "DL",
"trackNumber" : "9598"
} ],
"departureAirport" : "OSL",
"arrivalAirport" : "AMS",
"originDate" : "2020-01-22",
"departure" : {
"scheduled" : "2020-01-22T12:00:00+01:00",
"terminal" : "2"
},
"arrival" : {
"scheduled" : "2020-01-22T16:00:00+01:00",
"estimated" : "2020-01-22T16:03:00+01:00",
"actual" : "2020-01-22T16:03:00+01:00",
"terminal" : "2",
"gate" : "A4",
"baggageClaim" : {
"carousel" : "9"
}
},
"flightStatus" : "Landed"
}, {
"operatingAirline" : {
"iataCode" : "KL",
"icaoCode" : "KLM",
"name" : "KLM Royal Dutch Airlines"
},
"aircraftType" : {
"icaoCode" : "B738",
"modelName" : "Boeing 737-800 pax",
"registration" : "PHBXG"
},
"flightNumber" : {
"airlineCode" : "KL",
"trackNumber" : "1394"
},
"codeShares" : [ {
"airlineCode" : "DL",
"trackNumber" : "8204"
}, {
"airlineCode" : "KQ",
"trackNumber" : "1394"
}, {
"airlineCode" : "SU",
"trackNumber" : "3410"
} ],
"departureAirport" : "LED",
"arrivalAirport" : "AMS",
"originDate" : "2020-01-22",
"departure" : {
"scheduled" : "2020-01-22T12:00:00+03:00",
"terminal" : "3"
},
"arrival" : {
"scheduled" : "2020-01-22T16:00:00+01:00",
"estimated" : "2020-01-22T15:47:00+01:00",
"actual" : "2020-01-22T15:47:00+01:00",
"terminal" : "3",
"gate" : "A9",
"baggageClaim" : {
"carousel" : "15"
}
},
"flightStatus" : "Landed"
}, {
"operatingAirline" : {
"iataCode" : "KL",
"icaoCode" : "KLM",
"name" : "KLM Royal Dutch Airlines"
},
"aircraftType" : {
"icaoCode" : "B738",
"modelName" : "Boeing 737-800 pax",
"registration" : "PHHSE"
},
"flightNumber" : {
"airlineCode" : "KL",
"trackNumber" : "1386"
},
"codeShares" : [ {
"airlineCode" : "DL",
"trackNumber" : "9473"
}, {
"airlineCode" : "PS",
"trackNumber" : "9386"
} ],
"departureAirport" : "KBP",
"arrivalAirport" : "AMS",
"originDate" : "2020-01-22",
"departure" : {
"scheduled" : "2020-01-22T12:00:00+02:00",
"terminal" : "3"
},
"arrival" : {
"scheduled" : "2020-01-22T16:00:00+01:00",
"estimated" : "2020-01-22T15:44:00+01:00",
"actual" : "2020-01-22T15:44:00+01:00",
"terminal" : "3",
"gate" : "A9",
"baggageClaim" : {
"carousel" : "17"
}
},
"flightStatus" : "Landed"
}, {
"operatingAirline" : {
"iataCode" : "TP",
"icaoCode" : "TAP",
"name" : "TAP Portugal"
},
"aircraftType" : {
"icaoCode" : "A319",
"modelName" : "Airbus A319",
"registration" : "CSTTS"
},
"flightNumber" : {
"airlineCode" : "TP",
"trackNumber" : "678"
},
"departureAirport" : "OPO",
"arrivalAirport" : "AMS",
"originDate" : "2020-01-22",
"departure" : {
"scheduled" : "2020-01-22T12:00:00Z",
"terminal" : "1"
},
"arrival" : {
"scheduled" : "2020-01-22T16:00:00+01:00",
"estimated" : "2020-01-22T15:53:00+01:00",
"actual" : "2020-01-22T15:53:00+01:00",
"terminal" : "1",
"gate" : "C14",
"baggageClaim" : {
"carousel" : "6"
}
},
"flightStatus" : "Landed"
} ]
5 Appendix A Status Codes
Code | Description | Status Description | Departure Status | Arrival Status | Can Be Both? |
---|---|---|---|---|---|
AD | Arrived-Diverted | Flight has arrived at gate at diversion airport |
|
| ✔ |
AP | Approach | Flight is approaching destination airport |
| ✔ |
|
AR | Arrived | Flight has arrived at destination airport |
|
| ✔ |
AT | See Agent | Indicator of a see flight agent |
|
| ✔ |
BC | Boarding Complete | Boarding process has completed | ✔ |
|
|
BD | Boarding | Flight is open for boarding | ✔ |
|
|
BO | Boarded | Boarding process has completed | ✔ |
|
|
CD | Baggage Delay | Indicator of possible baggage delay |
| ✔ |
|
CO | Closed | Gate has closed | ✔ |
|
|
CL | Closed | Gate has closed | ✔ |
|
|
CX | Cancelled | Flight has been cancelled |
|
| ✔ |
DE | Deleted | Flight has been deleted |
|
| ✔ |
DL | Delayed | Flight has been delayed |
|
| ✔ |
DP | Departed | Flight has departed gate/pushed back |
|
| ✔ |
DV | Diverted | Flight has been diverted to another location |
|
| ✔ |
EN | Enroute | Flight is enroute |
| ✔ |
|
EX | Expected | Flight expected time of departure/arrival |
|
| ✔ |
FB | First Bag Unloaded | First bag has been unloaded |
| ✔ |
|
FC | Final Call | Final call to gate | ✔ |
|
|
GC | Gate Closed | Gate has closed | ✔ |
|
|
GG | Go To Gate | Passengers call to gate | ✔ |
|
|
GT | Gate Time (Gate Time HH:MM can be found in gateInfo field) | Gate information will be available at specified time |
|
| ✔ |
IA | In Air | Flight is in-air/taken off |
|
| ✔ |
ID | In Air-Diverted | Flight has been diverted to another location while in-air |
|
| ✔ |
IR | In Range | Flight is within the operational range of the airport’s navigation and communication systems |
|
| ✔ |
LB | Last Bag Unloaded | Last bag has been unloaded |
| ✔ |
|
LD | Landed-Diverted | Flight has landed at diversion airport |
|
| ✔ |
LN | Landed | Flight has landed at destination airport |
|
| ✔ |
LR | Landed-Recovered | Flight from diversion airport has landed at original destination airport |
|
| ✔ |
OG | Landed (On Ground) | Flight has landed at destination airport |
|
| ✔ |
ON | On Time | Flight is on-time |
|
| ✔ |
TX | Taxiing | Aircraft is taxiing |
|
| ✔ |
PD | Possible Delay | Indicator of a possible flight delay |
|
| ✔ |
RA | Arrived-Recovered | Flight from diversion airport has arrived at gate at original destination airport |
|
| ✔ |
RE | In Air-Recovered | Flight from diversion airport to original destination airport has taken off |
|
| ✔ |
RG | Return To Gate | Flight has attempted to take-off but has turned back-around to the gate | ✔ |
|
|
SC | Scheduled | Flight scheduled time of departure/arrival |
|
| ✔ |
UN | Unknown | Flight status is unknown or unavailable |
|
| ✔ |
VN | TEST | Test flight in system |
|
| ✔ |
WX | Weather | Indicated weather may have an impact of the flight operation |
|
| ✔ |
6 Appendix B Flight Status Use Cases
Note : The requests below can also be made for arrival flights by substituting the 'direction/D' in the request for 'direction/A'.
ALL FLIGHTS SEARCH FOR AN AIRPORT
Scenario: | As an API user I want to make a request to FLIFO to return all departures for a chosen airport. |
Request: | GET /flightinfo/v2/flights/airport/MUC/direction/D |
Response: | List of flight records for MUC departure flights with scheduled departure time between current UTC date/time and current UTC date/time +4 hours |
Scenario: | As an API user I want to make a request to FLIFO to return all departures for a chosen airport and see just the departure view of the flight |
Request: | GET /flightinfo/v2/flights/airport/MUC/direction/D?view=local |
Response: | List of flight records for MUC departure flights with scheduled departure time between current UTC date/time and current UTC date/time +4 hours |
Scenario: | As an API user I want to make a request to FLIFO to return all departures for a chosen airport and see both the departure and arrival details of the flights |
Request: | GET /flightinfo/v2/flights/airport/MUC/direction/D?view=full |
Response: | List of flight records for MUC departure flights with scheduled departure time between current UTC date/time and current UTC date/time +4 hours Response will contain both the departure and arrival details of the flights |
Scenario: | As an API user I want to make a request to FLIFO to return all departures for a chosen airport for a given timeframe. |
Request: | GET /flightinfo/v2/flights/airport/MUC/direction/D?pastWindow=8&futureWindow=8 |
Response: | List of flight records for MUC departure flights with scheduled departure time between current UTC date/time -8 hours and current UTC date/time +8 hours |
Scenario: | As an API user I want to make a request to FLIFO to return all departures for a chosen airport and only show flights with a destination of JFK |
Request: | GET /flightinfo/v2/flights/airport/MUC/direction/D?departureOrArrivalAirport=JFK |
Response: | List of flight records for MUC departure flights with scheduled departure time between current UTC date/time and current UTC date/time + 4 hours and destination JFK |
Scenario: | As an API user I want to make a request to FLIFO to return all departures for a chosen airport, with operating and marketing carrier flight records combined. |
Request: | GET /flightinfo/v2/flights/airport/MUC/direction/D?groupMarketingCarriers=true |
Response: | List of flight records for MUC departure flights with scheduled departure time between current UTC date/time and current UTC date/time + 4 hours. Flight records will have operating and marketing carrier details combined. |
Scenario: | List of flight records for MUC departure flights with scheduled departure time between current UTC date/time and current UTC date/time + 4 hours. Flight records will have operating and marketing carrier details combined. |
Request: | GET /flightinfo/v2/flights/airport/MUC/direction/D?showCargo=true |
Response: | List of flight records for MUC departure flights including cargo flights with scheduled departure time between current UTC date/time and current UTC date/time + 4 hours |
Scenario: | As an API user I want to make a request to FLIFO to return all departures for a chosen airport. |
Request: | GET /flightinfo/v2/flights/airport/MUC/direction/D?operationDate=2021-04-12 |
Response: | List of flight records for MUC departure flights with departures with a search window start time of 2021-04-12T00:00:00 |
Scenario: | As an API user I want to make a request to FLIFO to return all departures for a chosen airport. |
Request: | GET /flightinfo/v2/flights/airport/MUC/direction/D?operationDate=2021-04-12T14:00:00 |
Response: | List of flight records for MUC departures with a search window start time of 2021-04-12T14:00:00 |
ALL FLIGHTS SEARCH FOR AN AIRPORT & AIRLINE COMBINATION
Scenario: | As an API user I want to make a request to FLIFO to return all departures for a chosen airport/airline combination. |
Request: | GET /flightinfo/v2/flights/airport/MUC/airline/LH/direction/D |
Response: | List of flight records for MUC LH departure flights with scheduled departure time between current UTC date/time and current UTC date/time +4 hours |
Scenario: | As an API user I want to make a request to FLIFO to return all departures for a chosen airport/airline combination and see just the departure view of the flight |
Request: | GET /flightinfo/v2/flights/airport/MUC/airline/LH/direction/D?view=local |
Response: | List of flight records for MUC LH departure flights with scheduled departure time between current UTC date/time and current UTC date/time +4 hours |
Scenario: | As an API user I want to make a request to FLIFO to return all departures for a chosen airport/airline combination including cargo flights |
Request: | /flifo/v3/flights/MUC/LH/D?showCargo=true |
Response: | List of flight records for MUC LH departure flights including cargo flights with scheduled departure time between current UTC date/time and current UTC date/time + 4 hours |
Scenario: | As an API user I want to make a request to FLIFO to return all departures for a chosen airport/airline combination and only show flights with a destination of JFK. |
Request: | GET /flightinfo/v2/flights/airport/MUC/airline/LH/direction/D?departureOrArrivalAirport=JFKGET /flightinfo/v2/flights/airport/MUC/airline/LH/direction/D?departureOrArrivalAirport=JFK |
Response: | List of flight records for MUC LH departure flights with scheduled departure time between current UTC date/time and current UTC date/time + 4 hours and destination JFK. |
Scenario: | As an API user I want to make a request to FLIFO to return all departures for a chosen airport/airline combination, with operating and marketing carrier flight records combined |
Request: | GET /flightinfo/v2/flights/airport/MUC/airline/LH/direction/D?groupMarketingCarriers=true |
Response: | List of flight records for MUC LH departure flights with scheduled departure time between current UTC date/time and current UTC date/time + 4 hours. Flight records will have operating and marketing carrier details combined. |
Scenario: | As an API user I want to make a request to FLIFO to return all departures for a chosen airport/airline combination including cargo flights. |
Request: | GET /flightinfo/v2/flights/airport/MUC/airline/LH/direction/D?showCargo=true |
Response: | List of flight records for MUC LH departure flights including cargo flights with scheduled departure time between current UTC date/time and current UTC date/time + 4 hours. |
Scenario: | As an API user I want to make a request to FLIFO to return all departures for a chosen airport/airline combination.. |
Request: | GET /flightinfo/v2/flights/airport/MUC/airline/LH/direction/D?operationDate=2021-04-12 |
Response: | List of flight records for MUC LH departure flights with scheduled departure search window start time of 2021-04-12T00:00:00. |
Scenario: | As an API user I want to make a request to FLIFO to return all departures for a chosen airport/airline combination. |
Request: | GET /flightinfo/v2/flights/airport/MUC/airline/LH/direction/D?operationDate=2021-04-12T14:00:00 |
Response: | List of flight records for MUC LH departure flights with scheduled departure search window start time of 2021-04-12T14:00:00 |
INDIVIDUAL FLIGHT SEARCH FROM AN AIRPORT
Scenario: | As an API user I want to make a request to FLIFO to return details for a specific flight originating from an airport. |
Request: | GET /flightinfo/v2/flights/airport/MUC/airline/LH/flightNumber /2038/direction/D |
Response: | Flight record for LH2038 departing MUC on current UTC date |
Scenario: | As an API user I want to make a request to FLIFO to return details for a specific flight originating from an airport on a given date (local time). |
Request: | GET /flightinfo/v2/flights/airport/MUC/airline/LH/flightNumber/2038/direction/D?operationDate=2021-06-04 |
Response: | Flight record for LH2038 departing MUC on 2021-06-04 (local MUC date) |
Scenario: | As an API user I want to make a request to FLIFO to return details for a specific flight originating from an airport on a given date (UTC time). |
Request: | GET /flightinfo/v2/flights/airport/MUC/airline/LH/flightNumber /2038/direction/D?operationDate=2021-06-04& searchByUtc=true |
Response: | Flight record for LH2038 departing MUC on 2021-06-04 (UTC date) |
Scenario: | As an API user I want to make a request to FLIFO to return details for a specific flight originating from an airport and see just the departure view of the flight. |
Request: | GET /flightinfo/v2/flights/airport/MUC/airline/LH/flightNumber/2038/direction/D?view=local |
Response: | Flight record for LH2038 departing MUC on current UTC date. |
Scenario: | As an API user I want to make a request to FLIFO to return details for a specific flight originating from an airport for a given timeframe. |
Request: | GET /flightinfo/v2/flights/airport/MUC/airline/LH/flightNumber/2038/direction/D?pastWindow=8&futureWindow=8 |
Response: | Flight record for LH2038 departing MUC between current UTC date/time -8 hours and current UTC date/time +8 hours. |
Scenario: | As an API user I want to make a request to FLIFO to return details for a specific cargo flights originating from an airport. |
Request: | GET /flightinfo/v2/flights/airport/MUC/airline/LH/flightNumber /2038/direction/D?showCargo=true |
Response: | Flight record for Cargo Flight LH2038 departing MUC with a search window start time of 2021-04-12T00:00:00 |
Scenario: | As an API user I want to make a request to FLIFO to return all departures for a chosen airport/airline combination. |
Request: | GET /flightinfo/v2/flights/airport/MUC/airline/LH/flightNumber/2038/direction/D?operationDate=2021-04-12 |
Response: | Flight record for MUC LH 2038 departure flight with a search window start time of 2021-04-12T00:00:00 |
Scenario: | As an API user I want to make a request to FLIFO to return all departures for a chosen airport/airline combination.. |
Request: | GET /flightinfo/v2/flights/airport/MUC/airline/LH/flightNumber/2038/direction/D?operationDate=2021-04-12T14:00:00 |
Response: | Flight record for MUC LH 2038 departure flight with a search window start time of 2021-04-12T14:00:00 |
INDIVIDUAL FLIGHT SEARCH
Scenario: | As an API user I want to make a request to FLIFO to return details for a specific flight. |
Request: | GET /flightinfo/v2/flights/airline/LH/flightNumber/2038 |
Response: | Flight record for LH2038 on current UTC date. |
Scenario: | As an API user I want to make a request to FLIFO to return details for a specific flight for a given timeframe. |
Request: | GET /flightinfo/v2/flights/airline/LH/flightNumber/2038/direction/D?pastWindow=8&futureWindow=8 |
Response: | Flight record for LH2038 between current UTC date/time -8 hours and current UTC date/time +8 hours. |
Scenario: | As an API user I want to make a request to FLIFO to return details for a specific cargo flights. |
Request: | GET /flightinfo/v2/flights/airline/LH/flightNumber/2038/direction/D?showCargo=true |
Response: | Flight record for Cargo Flight LH2038 between current UTC date/time -8 hours and current UTC date/time +8 hours. |
Scenario: | As an API user I want to make a request to FLIFO to return details for a specific flight with a given operation date. |
Request: | GET /flightinfo/v2/flights/airline/LH/flightNumber/2038/direction/D?operationDate=2020-03-02 |
Response: | Flight record for LH2038 departing MUC with a search window start time on 2020-03-02T00:00:00. |
Scenario: | As an API user I want to make a request to FLIFO to return details for a specific flight with a given operation date. |
Request: | GET /flightinfo/v2/flights/airline/LH/flightNumber/2038/direction/D?operationDate=2020-03-02&searchByUtc=true |
Response: | Flight record for LH2038 departing MUC on 2020-03-02T00:00:00 (UTC date). |
Scenario: | As an API user I want to make a request to FLIFO to return details for a specific flight with a given operation date. |
Request: | GET /flightinfo/v2/flights/airline/LH/flightNumber /2038/direction/D?operationDate=2021-04-12T14:00:00 |
Response: | Flight record for LH2038 departing MUC with a search window start time of 2021-04-12T14:00:00. |
ACRIS/SeamlessTravel
ALL FLIGHTS SEARCH ACRIS
Note : The requests below can also be made for arrival flights by substituting the 'departure' in the request for 'arrival'.
Scenario: | As an API user I want to make a request to FLIFO to return all departures for a chosen airport. |
Request: | GET /aci-v1/flight/MUC/departure |
Response: | List of flight records for MUC departure flights with scheduled departure time between current UTC date/time and current UTC date/time +4 hours. The default number of records returned is 50. |
Scenario: | As an API user I want to make a request to FLIFO to return all departures for a chosen airport with the number of results limited to a specified amount. |
Request: | GET /aci-v1/flight/MUC/departure?length=10 |
Response: | List of flight records for MUC departure flights with scheduled departure time between current UTC date/time and current UTC date/time +4 hours. Number of records returned is limited to the first 10. |
Scenario: | As an API user I want to make a request to FLIFO to return all departures for a chosen airport with the number of results limited to a specified amount. |
Request: | GET /aci-v1/flight/MUC/departure?offset=7&length=10 |
Response: | List of flight records for MUC departure flights with scheduled departure time between current UTC date/time and current UTC date/time +4 hours. Number of records returned is limited. The list returned will have a size of 10 but the user has requested that the results returned begin at item 7 of the original list so the records in the payload will be records #7 through to #16 |
Scenario: | As an API user I want to make a request to FLIFO to return all departures for a chosen airport for x number of hours in advance. |
Request: | GET /aci-v1/flight/MUC/departure?timeRange=8 |
Response: | List of flight records for MUC departure flights with scheduled departure time between current UTC date/time and current UTC date/time +8 hours. The default number of records returned is 50. |
Scenario: | As an API user I want to make a request to FLIFO to return all departures for a chosen airport beginning from the specified date/time in ISO-8601 format. |
Request: | GET /aci-v1/flight/MUC/departure?startTime=2020-03-04T17:00:00.000 |
Response: | List of flight records for MUC departure flights with scheduled departure time between specified date/time and specified date/time +4 hours. The default number of records returned is 50. |
Scenario: | As an API user I want to make a request to FLIFO to return all departures for a chosen airport beginning from the specified date/time in ISO-8601 format for the chosen number of hours. |
Request: | GET /aci-v1/flight/MUC/departure?startTime=2020-03-04T17:00:00.000&timeRange=8 |
Response: | List of flight records for MUC departure flights with scheduled departure time between specified date/time and specified date/time +8 hours. The default number of records returned is 50. |
INDIVIDUAL FLIGHT SEARCH ACRIS
Note : The requests below can also be made for arrival flights by substituting the 'D' in the request for 'A'.
Scenario: | As an API user I want to make a request to FLIFO to return details for a specific flight. |
Request: | GET /aci-v1/flightDetails/BA/15/2020-03-04/LHR/SIN |
Response: | Flight record for BA15 departing on current UTC date. |
Scenario: | As an API user I want to make a request to FLIFO to return details for a specific flight with a suffix flight number. |
Request: | GET /aci-v1/flightDetails/BA/15/2020-03-04/LHR/SIN?suffix=F |
Response: | Flight record for BA15F departing on current UTC date |
7 Appendix C Diverted Flights
A diverted flight is a flight that has been re-routed from its original arrival destination to a new arrival destination.
Flight diversions are unforeseen events which can be caused by factors such as:
- Aircraft emergency
- Passenger emergency
- Mechanical failure
- Poor weather conditions
A recovery flight is a flight that is created to route the aircraft/passengers from the diversion airport to their original arrival destination.
When the Flight Status API service has been notified that a flight has been diverted a 'diversion' element is added to the departure flight record.
The diversion element contains a 'recovery' element which contains details of the airport where the flight has been diverted and also details of the recovery flight if/when it has been confirmed.
Diverted flight scenario
Original flight route was DEL → YYZ.
Flight was diverted after departure and now has routing of DEL → YUL → YYZ.
Departure flight record will be updated with details of the diversion/recovery flight.
The system will now contain two arrival records for AC43 at YYZ, one for the original scheduled arrival flight DEL → YYZ.
The other will be for the 'recovery' flight YUL → YYZ.
AC43 DEL → YYZ flight search
/flifo/flightinfo/v2/flights/airline/AC/flightNumber/43?operationDate=2022-05-11&view=full
{
"flightRecords": [
{
"flightIdentifier": {
"operatingCarrier": {
"iataCode": "AC",
"icaoCode": "ACA",
"flightNumber": "43",
"name": "Air Canada"
},
"marketingCarriers": [
{
"iataCode": "UA",
"icaoCode": "UAL",
"flightNumber": "8653",
"name": "United Airlines"
}
]
},
"departure": {
"airport": {
"iataCode": "YUL",
"icaoCode": "CYUL",
"cityText": "Montreal"
},
"scheduled": "2022-05-10T12:35:00-04:00",
"actual": "2022-05-10T22:13:00-04:00",
"status": "DV",
"statusText": "Diverted",
"diversion": {
"original": {
"airport": {
"iataCode": "DEL",
"icaoCode": "VIDP",
"cityText": "Delhi"
},
"flightNumber": "8653",
"iataCode": "UA",
"icaoCode": "UAL",
"name": "United Airlines",
"scheduled": "2022-05-10T12:35:00-04:00"
}
}
},
"arrival": {
"airport": {
"iataCode": "YYZ",
"icaoCode": "CYYZ",
"cityText": "Toronto"
},
"scheduled": "2022-05-11T05:40:00-04:00",
"estimated": "2022-05-11T06:25:00-04:00",
"status": "DV",
"statusText": "Diverted",
"diversion": {
"original": {
"airport": {
"iataCode": "DEL",
"icaoCode": "VIDP",
"cityText": "Delhi"
},
"flightNumber": "8653",
"iataCode": "UA",
"icaoCode": "UAL",
"name": "United Airlines",
"scheduled": "2022-05-11T05:40:00-04:00"
}
}
},
"serviceType": "J",
"duration": "1025"
},
{
"flightIdentifier": {
"operatingCarrier": {
"iataCode": "AC",
"flightNumber": "43",
"name": "Air Canada"
},
"marketingCarriers": [
{
"iataCode": "UA",
"flightNumber": "8653",
"name": "United Airlines"
}
],
"aircraft": {
"iataCode": "77L",
"model": "Boeing 777-200LR",
"registration": "CFNND"
}
},
"departure": {
"airport": {
"iataCode": "DEL",
"cityText": "New Delhi"
},
"scheduled": "2022-05-10T22:05:00+05:30",
"estimated": "2022-05-10T23:14:00+05:30",
"actual": "2022-05-10T23:18:00+05:30",
"status": "ID",
"statusText": "In Air-Diverted",
"terminal": "3",
"gate": "9",
"diversion": {
"recovery": {
"airport": {
"iataCode": "YUL",
"icaoCode": "CYUL",
"cityText": "Montreal"
},
"flightNumber": "8653",
"iataCode": "UA",
"icaoCode": "UAL",
"name": "United Airlines",
"scheduled": "2022-05-10T12:35:00-04:00"
}
}
},
"arrival": {
"airport": {
"iataCode": "YYZ",
"cityText": "Toronto"
},
"scheduled": "2022-05-11T05:40:00-04:00",
"estimated": "2022-05-11T06:36:00-04:00",
"status": "ID",
"statusText": "In Air-Diverted",
"terminal": "T1",
"gate": "E71",
"diversion": {
"recovery": {
"airport": {
"iataCode": "YUL",
"icaoCode": "CYUL",
"cityText": "Montreal"
},
"flightNumber": "8653",
"iataCode": "UA",
"icaoCode": "UAL",
"name": "United Airlines",
"scheduled": "2022-05-11T05:40:00-04:00"
}
}
},
"serviceType": "J",
"duration": "1025"
}
]
}
Linking diverted flights
The json on the left in the below example shows flight AC43 DEL → YYZ has been diverted. Both the departure and arrival details for this flight have been updated to contain a 'diversion.recovery' element.
The recovery element provides details of the recovery flight which has been created for this flight.
The json on the right in the below example shows flight AC43 YUL → YYZ which has been created as the recovery flight for AC43 DEL → YYZ.
Both the departure and arrival details for this flight have been updated to contain a 'diversion.original' element.
The original element provides details of the original flight which this flight is related to.