Skip to main content

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. Flight Status

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:

  1. Is my flight on time?
  2. Is my flight delayed?
  3. Is my flight cancelled?
  4. What is my departure or arrival gate, baggage claim and terminal?
  5. What is the likely duration of my flight?
  6. 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

SITA Advanced Data Services

version 2.2.0-SNAPSHOT

1 Revision History

DateDocument VersionDescription

10 May 2022

1.0

Initial version

22 Aug 2022

1.1

Service Type Codes Added

14 August 2023

1.2

Added rate limit and OAuth

16 July 2024

1.2

Added flightId element

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 the client_secret these should be base64 encoded in an Authorization header when sent to the OAuth endpoint. Please note the OAuth tokens have an expiry of one hour after the token has been retrieved, after the token has expired you will need to re-issue a request to get a new token.
curl --location 'https://sitaopen.api.aero/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

PathTypeDescription

errors

Object

Object that holds the error information

errors.error[]

Array

Array of errors

errors.error[].code

Number

API Internal Error Code

errors.error[].description

String

Error Description

errors.error[].invalidParam

String

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:

HeaderDescription

X-RateLimit-Limit

The total number of requests allowed in the current time window

X-RateLimit-Remaining

The number of requests left for the current time window

X-RateLimit-Policy

The policy describing how many request per time window are allowed

X-RateLimit-Reset

The number of seconds remaining in the current time window. Header not displayed after rate limit has been exceeded

retry-after

The epoch timestamp at which the current rate limit window resets. Header only displayed after rate limit has been exceeded

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
/flightinfo/v2/flights/airline/{airlineCode}/flightNumber/{flightNumber}
ParameterDescription

airlineCode

2-character airline IATA code or 3-character airline ICAO code

flightNumber

Flight number

Query parameters
ParameterDescription

operationDate

Local date of operation (yyyy-MM-dd). Default value is current UTC date

searchByUTC

Search based by UTC. Default value is false

showCargo

Include cargo flights. Default value is false

Request headers
NameOptionalDescription

Content-Type

false

Content type of this request. Required value is 'application/json'

Authorization

false

Authorization header that contains the access token.

Response fields
PathTypeDescription

flightRecords[]

Array

Flight Records

flightRecords[].arrival

Object

Arrival

flightRecords[].arrival.actual

String

The actual local departure/arrival time for this flight e.g 2020-01-22T12:00:00+03:00

flightRecords[].arrival.airport

Object

Airport

flightRecords[].arrival.airport.city

String

The city in which the airport is located e.g New York

flightRecords[].arrival.airport.cityText

String

The city in which the airport is located e.g New York

flightRecords[].arrival.airport.iataCode

String

3-character airport IATA code e.g JFK

flightRecords[].arrival.airport.icaoCode

String

4-character airport ICAO code e.g KJFK

flightRecords[].arrival.airport.name

String

The name of the airport e.g John F Kennedy International Airport

flightRecords[].arrival.carousel

String

Expected carousel(s) for baggage reclaim

flightRecords[].arrival.carouselSlots[]

Array

Carousel Slots

flightRecords[].arrival.carouselSlots[].area

String

Location details of the slot resource i.e check-in desks1-20, Gate 2C etc

flightRecords[].arrival.carouselSlots[].endTime

String

End time for the slot activity e.g check-in desk closed

flightRecords[].arrival.carouselSlots[].externalName

String

Name used to identify the slot

flightRecords[].arrival.carouselSlots[].name

String

Name used to identify the slot internally

flightRecords[].arrival.carouselSlots[].startTime

String

Start time for the slot activity e.g check-in desk opened

flightRecords[].arrival.checkIn

String

Check-in desk details e.g CK-1

flightRecords[].arrival.checkinSlots[]

Array

Checkin Slots

flightRecords[].arrival.checkinSlots[].area

String

Location details of the slot resource i.e check-in desks1-20, Gate 2C etc

flightRecords[].arrival.checkinSlots[].endTime

String

End time for the slot activity e.g check-in desk closed

flightRecords[].arrival.checkinSlots[].externalName

String

Name used to identify the slot

flightRecords[].arrival.checkinSlots[].name

String

Name used to identify the slot internally

flightRecords[].arrival.checkinSlots[].startTime

String

Start time for the slot activity e.g check-in desk opened

flightRecords[].arrival.chute

String

Baggage chute details e.g CH-2

flightRecords[].arrival.chuteSlots[]

Array

Chute Slots

flightRecords[].arrival.chuteSlots[].area

String

Location details of the slot resource i.e check-in desks1-20, Gate 2C etc

flightRecords[].arrival.chuteSlots[].endTime

String

End time for the slot activity e.g check-in desk closed

flightRecords[].arrival.chuteSlots[].externalName

String

Name used to identify the slot

flightRecords[].arrival.chuteSlots[].name

String

Name used to identify the slot internally

flightRecords[].arrival.chuteSlots[].startTime

String

Start time for the slot activity e.g check-in desk opened

flightRecords[].arrival.customProperties[]

Array

Custom Properties

flightRecords[].arrival.customProperties[].key

String

Key value used to identify a custom property

flightRecords[].arrival.customProperties[].value

String

The value of a custom property

flightRecords[].arrival.diversion

Object

Flight Diversion Details.

flightRecords[].arrival.diversion.original

Object

Flight Diversion original record

flightRecords[].arrival.diversion.original.airport

Object

Airport

flightRecords[].arrival.diversion.original.airport.city

String

The city in which the airport is located e.g New York

flightRecords[].arrival.diversion.original.airport.cityText

String

The city in which the airport is located e.g New York

flightRecords[].arrival.diversion.original.airport.iataCode

String

3-character airport IATA code e.g JFK

flightRecords[].arrival.diversion.original.airport.icaoCode

String

4-character airport ICAO code e.g KJFK

flightRecords[].arrival.diversion.original.airport.name

String

The name of the airport e.g John F Kennedy International Airport

flightRecords[].arrival.diversion.original.flightNumber

String

Diversion flight original flight number

flightRecords[].arrival.diversion.original.iataCode

String

Diversion flight original airline iata code

flightRecords[].arrival.diversion.original.icaoCode

String

Diversion flight original airline icao code

flightRecords[].arrival.diversion.original.name

String

Diversion flight original airline name

flightRecords[].arrival.diversion.original.scheduled

String

Diversion flight original scheduled date of operation

flightRecords[].arrival.diversion.recovery

Object

Flight Diversion recovery record

flightRecords[].arrival.diversion.recovery.airport

Object

Airport

flightRecords[].arrival.diversion.recovery.airport.city

String

The city in which the airport is located e.g New York

flightRecords[].arrival.diversion.recovery.airport.cityText

String

The city in which the airport is located e.g New York

flightRecords[].arrival.diversion.recovery.airport.iataCode

String

3-character airport IATA code e.g JFK

flightRecords[].arrival.diversion.recovery.airport.icaoCode

String

4-character airport ICAO code e.g KJFK

flightRecords[].arrival.diversion.recovery.airport.name

String

The name of the airport e.g John F Kennedy International Airport

flightRecords[].arrival.diversion.recovery.flightNumber

String

Diversion flight recovery flight number

flightRecords[].arrival.diversion.recovery.iataCode

String

Diversion flight recovery airline iata code

flightRecords[].arrival.diversion.recovery.icaoCode

String

Diversion flight recovery airline icao code

flightRecords[].arrival.diversion.recovery.name

String

Diversion flight recovery airline name

flightRecords[].arrival.diversion.recovery.scheduled

String

Diversion flight recovery scheduled date of operation

flightRecords[].arrival.estimated

String

The latest estimated local departure/arrival time for this flight e.g 2020-01-22T12:00:00+03:00

flightRecords[].arrival.events

Object

Flight events.

flightRecords[].arrival.events.AIBT

String

The actual local time at which the aircraft arrived at the gate

flightRecords[].arrival.events.ALDT

String

The actual local time at which the aircraft landed on the runway

flightRecords[].arrival.events.AOBT

String

The actual local time at which the aircraft left the gate

flightRecords[].arrival.events.ATOT

String

The actual local time at which the aircraft left the runway

flightRecords[].arrival.events.EIBT

String

The estimated local time at which the aircraft is expected at the gate

flightRecords[].arrival.events.ELDT

String

The estimated local time at which the aircraft is expected to land on the runway

flightRecords[].arrival.events.EOBT

String

The estimated local time at which the aircraft is expected to leave the gate

flightRecords[].arrival.events.ETOT

String

The estimated local time at which the aircraft is expected to leave the runway

flightRecords[].arrival.events.TOBT

String

The local time at which the aircraft is targeted to leave the gate

flightRecords[].arrival.events.TTOT

String

The local time at which the aircraft is targeted to leave the runway

flightRecords[].arrival.gate

String

The flights departure/arrival gate e.g C1

flightRecords[].arrival.gateRemark

String

Arrival gate remark

flightRecords[].arrival.gateRemarkText

String

Gate remark text when applicable e.g Boarding at 21:00

flightRecords[].arrival.gateSlots[]

Array

Gate Slots

flightRecords[].arrival.gateSlots[].area

String

Location details of the slot resource i.e check-in desks1-20, Gate 2C etc

flightRecords[].arrival.gateSlots[].endTime

String

End time for the slot activity e.g check-in desk closed

flightRecords[].arrival.gateSlots[].externalName

String

Name used to identify the slot

flightRecords[].arrival.gateSlots[].name

String

Name used to identify the slot internally

flightRecords[].arrival.gateSlots[].startTime

String

Start time for the slot activity e.g check-in desk opened

flightRecords[].arrival.route[]

Array

Route

flightRecords[].arrival.route[].iataCode

String

3-character airport IATA code

flightRecords[].arrival.route[].icaoCode

String

4-character airport ICAO code

flightRecords[].arrival.route[].sequenceNumber

String

Value used to identify the routes position within an entire flight route e.g leg 0, leg 1, leg 2 etc

flightRecords[].arrival.scheduled

String

The published scheduled local departure/arrival time for this flight e.g 2020-01-22T12:00:00+03:00

flightRecords[].arrival.stand

String

Aircraft stand details e.g S12

flightRecords[].arrival.standSlots[]

Array

Stand Slots

flightRecords[].arrival.standSlots[].area

String

Location details of the slot resource i.e check-in desks1-20, Gate 2C etc

flightRecords[].arrival.standSlots[].endTime

String

End time for the slot activity e.g check-in desk closed

flightRecords[].arrival.standSlots[].externalName

String

Name used to identify the slot

flightRecords[].arrival.standSlots[].name

String

Name used to identify the slot internally

flightRecords[].arrival.standSlots[].startTime

String

Start time for the slot activity e.g check-in desk opened

flightRecords[].arrival.status

String

The current status code for this flight e.g SC, DP

flightRecords[].arrival.statusText

String

The current status text for this flight e.g Scheduled, Departed

flightRecords[].arrival.terminal

String

The flights departure/arrival terminal e.g T1

flightRecords[].arrival.updates[]

Array

Updates

flightRecords[].arrival.updates[].current

String

Current field value

flightRecords[].arrival.updates[].previous

String

Previous field value

flightRecords[].arrival.updates[].received

String

UTC timestamp when update was applied

flightRecords[].arrival.updates[].updatedField

Object

Payload field which was updated

flightRecords[].arrival.version

Number

FLIFO internal version number

flightRecords[].departure

Object

Departure

flightRecords[].departure.actual

String

The actual local departure/arrival time for this flight e.g 2020-01-22T12:00:00+03:00

flightRecords[].departure.airport

Object

Airport

flightRecords[].departure.airport.city

String

The city in which the airport is located e.g New York

flightRecords[].departure.airport.cityText

String

The city in which the airport is located e.g New York

flightRecords[].departure.airport.iataCode

String

3-character airport IATA code e.g JFK

flightRecords[].departure.airport.icaoCode

String

4-character airport ICAO code e.g KJFK

flightRecords[].departure.airport.name

String

The name of the airport e.g John F Kennedy International Airport

flightRecords[].departure.carousel

String

Expected carousel(s) for baggage reclaim

flightRecords[].departure.carouselSlots[]

Array

Carousel Slots

flightRecords[].departure.carouselSlots[].area

String

Location details of the slot resource i.e check-in desks1-20, Gate 2C etc

flightRecords[].departure.carouselSlots[].endTime

String

End time for the slot activity e.g check-in desk closed

flightRecords[].departure.carouselSlots[].externalName

String

Name used to identify the slot

flightRecords[].departure.carouselSlots[].name

String

Name used to identify the slot internally

flightRecords[].departure.carouselSlots[].startTime

String

Start time for the slot activity e.g check-in desk opened

flightRecords[].departure.checkIn

String

Check-in desk details e.g CK-1

flightRecords[].departure.checkinSlots[]

Array

Checkin Slots

flightRecords[].departure.checkinSlots[].area

String

Location details of the slot resource i.e check-in desks1-20, Gate 2C etc

flightRecords[].departure.checkinSlots[].endTime

String

End time for the slot activity e.g check-in desk closed

flightRecords[].departure.checkinSlots[].externalName

String

Name used to identify the slot

flightRecords[].departure.checkinSlots[].name

String

Name used to identify the slot internally

flightRecords[].departure.checkinSlots[].startTime

String

Start time for the slot activity e.g check-in desk opened

flightRecords[].departure.chute

String

Baggage chute details e.g CH-2

flightRecords[].departure.chuteSlots[]

Array

Chute Slots

flightRecords[].departure.chuteSlots[].area

String

Location details of the slot resource i.e check-in desks1-20, Gate 2C etc

flightRecords[].departure.chuteSlots[].endTime

String

End time for the slot activity e.g check-in desk closed

flightRecords[].departure.chuteSlots[].externalName

String

Name used to identify the slot

flightRecords[].departure.chuteSlots[].name

String

Name used to identify the slot internally

flightRecords[].departure.chuteSlots[].startTime

String

Start time for the slot activity e.g check-in desk opened

flightRecords[].departure.customProperties[]

Array

Custom Properties

flightRecords[].departure.customProperties[].key

String

Key value used to identify a custom property

flightRecords[].departure.customProperties[].value

String

The value of a custom property

flightRecords[].departure.diversion

Object

Flight Diversion Details.

flightRecords[].departure.diversion.original

Object

Flight Diversion original record

flightRecords[].departure.diversion.original.airport

Object

Airport

flightRecords[].departure.diversion.original.airport.city

String

The city in which the airport is located e.g New York

flightRecords[].departure.diversion.original.airport.cityText

String

The city in which the airport is located e.g New York

flightRecords[].departure.diversion.original.airport.iataCode

String

3-character airport IATA code e.g JFK

flightRecords[].departure.diversion.original.airport.icaoCode

String

4-character airport ICAO code e.g KJFK

flightRecords[].departure.diversion.original.airport.name

String

The name of the airport e.g John F Kennedy International Airport

flightRecords[].departure.diversion.original.flightNumber

String

Diversion flight original flight number

flightRecords[].departure.diversion.original.iataCode

String

Diversion flight original airline iata code

flightRecords[].departure.diversion.original.icaoCode

String

Diversion flight original airline icao code

flightRecords[].departure.diversion.original.name

String

Diversion flight original airline name

flightRecords[].departure.diversion.original.scheduled

String

Diversion flight original scheduled date of operation

flightRecords[].departure.diversion.recovery

Object

Flight Diversion recovery record

flightRecords[].departure.diversion.recovery.airport

Object

Airport

flightRecords[].departure.diversion.recovery.airport.city

String

The city in which the airport is located e.g New York

flightRecords[].departure.diversion.recovery.airport.cityText

String

The city in which the airport is located e.g New York

flightRecords[].departure.diversion.recovery.airport.iataCode

String

3-character airport IATA code e.g JFK

flightRecords[].departure.diversion.recovery.airport.icaoCode

String

4-character airport ICAO code e.g KJFK

flightRecords[].departure.diversion.recovery.airport.name

String

The name of the airport e.g John F Kennedy International Airport

flightRecords[].departure.diversion.recovery.flightNumber

String

Diversion flight recovery flight number

flightRecords[].departure.diversion.recovery.iataCode

String

Diversion flight recovery airline iata code

flightRecords[].departure.diversion.recovery.icaoCode

String

Diversion flight recovery airline icao code

flightRecords[].departure.diversion.recovery.name

String

Diversion flight recovery airline name

flightRecords[].departure.diversion.recovery.scheduled

String

Diversion flight recovery scheduled date of operation

flightRecords[].departure.estimated

String

The latest estimated local departure/arrival time for this flight e.g 2020-01-22T12:00:00+03:00

flightRecords[].departure.events

Object

Flight events.

flightRecords[].departure.events.AIBT

String

The actual local time at which the aircraft arrived at the gate

flightRecords[].departure.events.ALDT

String

The actual local time at which the aircraft landed on the runway

flightRecords[].departure.events.AOBT

String

The actual local time at which the aircraft left the gate

flightRecords[].departure.events.ATOT

String

The actual local time at which the aircraft left the runway

flightRecords[].departure.events.EIBT

String

The estimated local time at which the aircraft is expected at the gate

flightRecords[].departure.events.ELDT

String

The estimated local time at which the aircraft is expected to land on the runway

flightRecords[].departure.events.EOBT

String

The estimated local time at which the aircraft is expected to leave the gate

flightRecords[].departure.events.ETOT

String

The estimated local time at which the aircraft is expected to leave the runway

flightRecords[].departure.events.TOBT

String

The local time at which the aircraft is targeted to leave the gate

flightRecords[].departure.events.TTOT

String

The local time at which the aircraft is targeted to leave the runway

flightRecords[].departure.gate

String

The flights departure/arrival gate e.g C1

flightRecords[].departure.gateRemark

String

Departure gate remark

flightRecords[].departure.gateRemarkText

String

Gate remark text when applicable e.g Boarding at 21:00

flightRecords[].departure.gateSlots[]

Array

Gate Slots

flightRecords[].departure.gateSlots[].area

String

Location details of the slot resource i.e check-in desks1-20, Gate 2C etc

flightRecords[].departure.gateSlots[].endTime

String

End time for the slot activity e.g check-in desk closed

flightRecords[].departure.gateSlots[].externalName

String

Name used to identify the slot

flightRecords[].departure.gateSlots[].name

String

Name used to identify the slot internally

flightRecords[].departure.gateSlots[].startTime

String

Start time for the slot activity e.g check-in desk opened

flightRecords[].departure.route[]

Array

Route

flightRecords[].departure.route[].iataCode

String

3-character airport IATA code

flightRecords[].departure.route[].icaoCode

String

4-character airport ICAO code

flightRecords[].departure.route[].sequenceNumber

String

Value used to identify the routes position within an entire flight route e.g leg 0, leg 1, leg 2 etc

flightRecords[].departure.scheduled

String

The published scheduled local departure/arrival time for this flight e.g 2020-01-22T12:00:00+03:00

flightRecords[].departure.stand

String

Aircraft stand details e.g S12

flightRecords[].departure.standSlots[]

Array

Stand Slots

flightRecords[].departure.standSlots[].area

String

Location details of the slot resource i.e check-in desks1-20, Gate 2C etc

flightRecords[].departure.standSlots[].endTime

String

End time for the slot activity e.g check-in desk closed

flightRecords[].departure.standSlots[].externalName

String

Name used to identify the slot

flightRecords[].departure.standSlots[].name

String

Name used to identify the slot internally

flightRecords[].departure.standSlots[].startTime

String

Start time for the slot activity e.g check-in desk opened

flightRecords[].departure.status

String

The current status code for this flight e.g SC, DP

flightRecords[].departure.statusText

String

The current status text for this flight e.g Scheduled, Departed

flightRecords[].departure.terminal

String

The flights departure/arrival terminal e.g T1

flightRecords[].departure.updates[]

Array

Updates

flightRecords[].departure.updates[].current

String

Current field value

flightRecords[].departure.updates[].previous

String

Previous field value

flightRecords[].departure.updates[].received

String

UTC timestamp when update was applied

flightRecords[].departure.updates[].updatedField

Object

Payload field which was updated

flightRecords[].departure.version

Number

FLIFO internal version number

flightRecords[].duration

String

Flight duration in minutes e.g 60

flightRecords[].flightIdentifier

Object

Flight Identifier

flightRecords[].flightIdentifier.aircraft

Object

Aircraft

flightRecords[].flightIdentifier.aircraft.callSign

String

Callsign for the aircraft type

flightRecords[].flightIdentifier.aircraft.iataCode

String

IATA code for the aircraft

flightRecords[].flightIdentifier.aircraft.icaoCode

String

ICAO code for the aircraft

flightRecords[].flightIdentifier.aircraft.model

String

Specific aircraft model details

flightRecords[].flightIdentifier.aircraft.registration

String

Aircraft regristration/tail number details e.g EIAA44W

flightRecords[].flightIdentifier.flightId

String

A value that uniquely identifies a flight within the system

flightRecords[].flightIdentifier.marketingCarriers[]

Array

Marketing Carriers

flightRecords[].flightIdentifier.marketingCarriers[].flightNumber

String

Flight number e.g 1234

flightRecords[].flightIdentifier.marketingCarriers[].iataCode

String

2-character airline IATA code e.g AA

flightRecords[].flightIdentifier.marketingCarriers[].icaoCode

String

3-character airline ICAO code e.g AAL

flightRecords[].flightIdentifier.marketingCarriers[].name

String

Name of airline e.g American Airlines

flightRecords[].flightIdentifier.operatingCarrier

Object

Operating Carrier

flightRecords[].flightIdentifier.operatingCarrier.flightNumber

String

Flight number e.g 1234

flightRecords[].flightIdentifier.operatingCarrier.iataCode

String

2-character airline IATA code e.g AA

flightRecords[].flightIdentifier.operatingCarrier.icaoCode

String

3-character airline ICAO code e.g AAL

flightRecords[].flightIdentifier.operatingCarrier.name

String

Name of airline e.g American Airlines

flightRecords[].flightStats

Object

Flight Stats

flightRecords[].flightStats.baggage

Object

Baggage

flightRecords[].flightStats.baggage.cargo

String

Total number of cargo pieces

flightRecords[].flightStats.baggage.count

String

Total number of bags/pieces

flightRecords[].flightStats.baggage.load

String

Load breakdown

flightRecords[].flightStats.baggage.mail

String

Total number of mail pieces

flightRecords[].flightStats.baggage.totalWeight

String

Total weight of bags/pieces

flightRecords[].flightStats.passengers

Object

Passengers

flightRecords[].flightStats.passengers.actualBusiness

String

Actual number of business class passengers

flightRecords[].flightStats.passengers.actualEconomy

String

Actual number of economy class passengers

flightRecords[].flightStats.passengers.actualFirst

String

Actual number of 1st class passengers

flightRecords[].flightStats.passengers.actualTotal

String

Actual number of passengers

flightRecords[].flightStats.passengers.actualTransfer

String

Actual number of transfer passengers

flightRecords[].flightStats.passengers.actualTransit

String

Actual number of transit passengers

flightRecords[].flightStats.passengers.adult

String

Total number of adults

flightRecords[].flightStats.passengers.bookedBusiness

String

Total number of booked business class passengers

flightRecords[].flightStats.passengers.bookedEconomy

String

Total number of booked economy class passengers

flightRecords[].flightStats.passengers.bookedFirst

String

Total number of booked 1st class passengers

flightRecords[].flightStats.passengers.bookedTotal

String

Total number of booked passengers

flightRecords[].flightStats.passengers.child

String

Total number of children

flightRecords[].flightStats.passengers.infant

String

Total number of infants

flightRecords[].flightStats.passengers.reducedMobility

String

Total number of reduced mobility passengers e.g those requiring assistance boarding the aircraft etc.

flightRecords[].metadata.lastUpdateTime

String

UTC timestamp when last update update was applied to this flight

flightRecords[].metadata.provider

String

Data source of the last update applied to this flight

flightRecords[].serviceType

String

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
/flightinfo/v2/flights/airport/{airportCode}/airline/{airlineCode}/direction/{direction}
ParameterDescription

airportCode

3-character airport IATA code or 4-character airport ICAO code

airlineCode

2-character airline IATA code or 3-character airline ICAO code

direction

1-character direction indicator (A/D)

Query parameters
ParameterDescription

operationDate

Local date/datetime of operation (yyyy-MM-dd or yyyy-MM-ddTHH:mm:ss). Default value is current UTC date

pastWindow

Hours in past to return. Default value is 0

futureWindow

Hours in future to return. Default value is 4

searchByUTC

Search based by UTC. Default value is false

showCargo

Include cargo flights. Default value is false

groupMarketingCarriers

Group marketing and operating carrier flights into a single record. Default value is false

departureOrArrivalAirport

Filter results based on origin or destination airport

view

View 'full' or 'local' leg, based on direction. Default value is local. See notes for further details.

Request headers
NameOptionalDescription

Content-Type

false

Content type of this request. Required value is 'application/json'

Authorization

false

Authorization header that contains the access token.

Response fields
PathTypeDescription

flightRecords[]

Array

Flight Records

flightRecords[].arrival

Object

Arrival

flightRecords[].arrival.actual

String

The actual local departure/arrival time for this flight e.g 2020-01-22T12:00:00+03:00

flightRecords[].arrival.airport

Object

Airport

flightRecords[].arrival.airport.city

String

The city in which the airport is located e.g New York

flightRecords[].arrival.airport.cityText

String

The city in which the airport is located e.g New York

flightRecords[].arrival.airport.iataCode

String

3-character airport IATA code e.g JFK

flightRecords[].arrival.airport.icaoCode

String

4-character airport ICAO code e.g KJFK

flightRecords[].arrival.airport.name

String

The name of the airport e.g John F Kennedy International Airport

flightRecords[].arrival.carousel

String

Expected carousel(s) for baggage reclaim

flightRecords[].arrival.carouselSlots[]

Array

Carousel Slots

flightRecords[].arrival.carouselSlots[].area

String

Location details of the slot resource i.e check-in desks1-20, Gate 2C etc

flightRecords[].arrival.carouselSlots[].endTime

String

End time for the slot activity e.g check-in desk closed

flightRecords[].arrival.carouselSlots[].externalName

String

Name used to identify the slot

flightRecords[].arrival.carouselSlots[].name

String

Name used to identify the slot internally

flightRecords[].arrival.carouselSlots[].startTime

String

Start time for the slot activity e.g check-in desk opened

flightRecords[].arrival.checkIn

String

Check-in desk details e.g CK-1

flightRecords[].arrival.checkinSlots[]

Array

Checkin Slots

flightRecords[].arrival.checkinSlots[].area

String

Location details of the slot resource i.e check-in desks1-20, Gate 2C etc

flightRecords[].arrival.checkinSlots[].endTime

String

End time for the slot activity e.g check-in desk closed

flightRecords[].arrival.checkinSlots[].externalName

String

Name used to identify the slot

flightRecords[].arrival.checkinSlots[].name

String

Name used to identify the slot internally

flightRecords[].arrival.checkinSlots[].startTime

String

Start time for the slot activity e.g check-in desk opened

flightRecords[].arrival.chute

String

Baggage chute details e.g CH-2

flightRecords[].arrival.chuteSlots[]

Array

Chute Slots

flightRecords[].arrival.chuteSlots[].area

String

Location details of the slot resource i.e check-in desks1-20, Gate 2C etc

flightRecords[].arrival.chuteSlots[].endTime

String

End time for the slot activity e.g check-in desk closed

flightRecords[].arrival.chuteSlots[].externalName

String

Name used to identify the slot

flightRecords[].arrival.chuteSlots[].name

String

Name used to identify the slot internally

flightRecords[].arrival.chuteSlots[].startTime

String

Start time for the slot activity e.g check-in desk opened

flightRecords[].arrival.customProperties[]

Array

Custom Properties

flightRecords[].arrival.customProperties[].key

String

Key value used to identify a custom property

flightRecords[].arrival.customProperties[].value

String

The value of a custom property

flightRecords[].arrival.diversion

Object

Flight Diversion Details.

flightRecords[].arrival.diversion.original

Object

Flight Diversion original record

flightRecords[].arrival.diversion.original.airport

Object

Airport

flightRecords[].arrival.diversion.original.airport.city

String

The city in which the airport is located e.g New York

flightRecords[].arrival.diversion.original.airport.cityText

String

The city in which the airport is located e.g New York

flightRecords[].arrival.diversion.original.airport.iataCode

String

3-character airport IATA code e.g JFK

flightRecords[].arrival.diversion.original.airport.icaoCode

String

4-character airport ICAO code e.g KJFK

flightRecords[].arrival.diversion.original.airport.name

String

The name of the airport e.g John F Kennedy International Airport

flightRecords[].arrival.diversion.original.flightNumber

String

Diversion flight original flight number

flightRecords[].arrival.diversion.original.iataCode

String

Diversion flight original airline iata code

flightRecords[].arrival.diversion.original.icaoCode

String

Diversion flight original airline icao code

flightRecords[].arrival.diversion.original.name

String

Diversion flight original airline name

flightRecords[].arrival.diversion.original.scheduled

String

Diversion flight original scheduled date of operation

flightRecords[].arrival.diversion.recovery

Object

Flight Diversion recovery record

flightRecords[].arrival.diversion.recovery.airport

Object

Airport

flightRecords[].arrival.diversion.recovery.airport.city

String

The city in which the airport is located e.g New York

flightRecords[].arrival.diversion.recovery.airport.cityText

String

The city in which the airport is located e.g New York

flightRecords[].arrival.diversion.recovery.airport.iataCode

String

3-character airport IATA code e.g JFK

flightRecords[].arrival.diversion.recovery.airport.icaoCode

String

4-character airport ICAO code e.g KJFK

flightRecords[].arrival.diversion.recovery.airport.name

String

The name of the airport e.g John F Kennedy International Airport

flightRecords[].arrival.diversion.recovery.flightNumber

String

Diversion flight recovery flight number

flightRecords[].arrival.diversion.recovery.iataCode

String

Diversion flight recovery airline iata code

flightRecords[].arrival.diversion.recovery.icaoCode

String

Diversion flight recovery airline icao code

flightRecords[].arrival.diversion.recovery.name

String

Diversion flight recovery airline name

flightRecords[].arrival.diversion.recovery.scheduled

String

Diversion flight recovery scheduled date of operation

flightRecords[].arrival.estimated

String

The latest estimated local departure/arrival time for this flight e.g 2020-01-22T12:00:00+03:00

flightRecords[].arrival.events

Object

Flight events.

flightRecords[].arrival.events.AIBT

String

The actual local time at which the aircraft arrived at the gate

flightRecords[].arrival.events.ALDT

String

The actual local time at which the aircraft landed on the runway

flightRecords[].arrival.events.AOBT

String

The actual local time at which the aircraft left the gate

flightRecords[].arrival.events.ATOT

String

The actual local time at which the aircraft left the runway

flightRecords[].arrival.events.EIBT

String

The estimated local time at which the aircraft is expected at the gate

flightRecords[].arrival.events.ELDT

String

The estimated local time at which the aircraft is expected to land on the runway

flightRecords[].arrival.events.EOBT

String

The estimated local time at which the aircraft is expected to leave the gate

flightRecords[].arrival.events.ETOT

String

The estimated local time at which the aircraft is expected to leave the runway

flightRecords[].arrival.events.TOBT

String

The local time at which the aircraft is targeted to leave the gate

flightRecords[].arrival.events.TTOT

String

The local time at which the aircraft is targeted to leave the runway

flightRecords[].arrival.gate

String

The flights departure/arrival gate e.g C1

flightRecords[].arrival.gateRemark

String

Arrival gate remark

flightRecords[].arrival.gateRemarkText

String

Gate remark text when applicable e.g Boarding at 21:00

flightRecords[].arrival.gateSlots[]

Array

Gate Slots

flightRecords[].arrival.gateSlots[].area

String

Location details of the slot resource i.e check-in desks1-20, Gate 2C etc

flightRecords[].arrival.gateSlots[].endTime

String

End time for the slot activity e.g check-in desk closed

flightRecords[].arrival.gateSlots[].externalName

String

Name used to identify the slot

flightRecords[].arrival.gateSlots[].name

String

Name used to identify the slot internally

flightRecords[].arrival.gateSlots[].startTime

String

Start time for the slot activity e.g check-in desk opened

flightRecords[].arrival.route[]

Array

Route

flightRecords[].arrival.route[].iataCode

String

3-character airport IATA code

flightRecords[].arrival.route[].icaoCode

String

4-character airport ICAO code

flightRecords[].arrival.route[].sequenceNumber

String

Value used to identify the routes position within an entire flight route e.g leg 0, leg 1, leg 2 etc

flightRecords[].arrival.scheduled

String

The published scheduled local departure/arrival time for this flight e.g 2020-01-22T12:00:00+03:00

flightRecords[].arrival.stand

String

Aircraft stand details e.g S12

flightRecords[].arrival.standSlots[]

Array

Stand Slots

flightRecords[].arrival.standSlots[].area

String

Location details of the slot resource i.e check-in desks1-20, Gate 2C etc

flightRecords[].arrival.standSlots[].endTime

String

End time for the slot activity e.g check-in desk closed

flightRecords[].arrival.standSlots[].externalName

String

Name used to identify the slot

flightRecords[].arrival.standSlots[].name

String

Name used to identify the slot internally

flightRecords[].arrival.standSlots[].startTime

String

Start time for the slot activity e.g check-in desk opened

flightRecords[].arrival.status

String

The current status code for this flight e.g SC, DP

flightRecords[].arrival.statusText

String

The current status text for this flight e.g Scheduled, Departed

flightRecords[].arrival.terminal

String

The flights departure/arrival terminal e.g T1

flightRecords[].arrival.updates[]

Array

Updates

flightRecords[].arrival.updates[].current

String

Current field value

flightRecords[].arrival.updates[].previous

String

Previous field value

flightRecords[].arrival.updates[].received

String

UTC timestamp when update was applied

flightRecords[].arrival.updates[].updatedField

Object

Payload field which was updated

flightRecords[].arrival.version

Number

FLIFO internal version number

flightRecords[].departure

Object

Departure

flightRecords[].departure.actual

String

The actual local departure/arrival time for this flight e.g 2020-01-22T12:00:00+03:00

flightRecords[].departure.airport

Object

Airport

flightRecords[].departure.airport.city

String

The city in which the airport is located e.g New York

flightRecords[].departure.airport.cityText

String

The city in which the airport is located e.g New York

flightRecords[].departure.airport.iataCode

String

3-character airport IATA code e.g JFK

flightRecords[].departure.airport.icaoCode

String

4-character airport ICAO code e.g KJFK

flightRecords[].departure.airport.name

String

The name of the airport e.g John F Kennedy International Airport

flightRecords[].departure.carousel

String

Expected carousel(s) for baggage reclaim

flightRecords[].departure.carouselSlots[]

Array

Carousel Slots

flightRecords[].departure.carouselSlots[].area

String

Location details of the slot resource i.e check-in desks1-20, Gate 2C etc

flightRecords[].departure.carouselSlots[].endTime

String

End time for the slot activity e.g check-in desk closed

flightRecords[].departure.carouselSlots[].externalName

String

Name used to identify the slot

flightRecords[].departure.carouselSlots[].name

String

Name used to identify the slot internally

flightRecords[].departure.carouselSlots[].startTime

String

Start time for the slot activity e.g check-in desk opened

flightRecords[].departure.checkIn

String

Check-in desk details e.g CK-1

flightRecords[].departure.checkinSlots[]

Array

Checkin Slots

flightRecords[].departure.checkinSlots[].area

String

Location details of the slot resource i.e check-in desks1-20, Gate 2C etc

flightRecords[].departure.checkinSlots[].endTime

String

End time for the slot activity e.g check-in desk closed

flightRecords[].departure.checkinSlots[].externalName

String

Name used to identify the slot

flightRecords[].departure.checkinSlots[].name

String

Name used to identify the slot internally

flightRecords[].departure.checkinSlots[].startTime

String

Start time for the slot activity e.g check-in desk opened

flightRecords[].departure.chute

String

Baggage chute details e.g CH-2

flightRecords[].departure.chuteSlots[]

Array

Chute Slots

flightRecords[].departure.chuteSlots[].area

String

Location details of the slot resource i.e check-in desks1-20, Gate 2C etc

flightRecords[].departure.chuteSlots[].endTime

String

End time for the slot activity e.g check-in desk closed

flightRecords[].departure.chuteSlots[].externalName

String

Name used to identify the slot

flightRecords[].departure.chuteSlots[].name

String

Name used to identify the slot internally

flightRecords[].departure.chuteSlots[].startTime

String

Start time for the slot activity e.g check-in desk opened

flightRecords[].departure.customProperties[]

Array

Custom Properties

flightRecords[].departure.customProperties[].key

String

Key value used to identify a custom property

flightRecords[].departure.customProperties[].value

String

The value of a custom property

flightRecords[].departure.diversion

Object

Flight Diversion Details.

flightRecords[].departure.diversion.original

Object

Flight Diversion original record

flightRecords[].departure.diversion.original.airport

Object

Airport

flightRecords[].departure.diversion.original.airport.city

String

The city in which the airport is located e.g New York

flightRecords[].departure.diversion.original.airport.cityText

String

The city in which the airport is located e.g New York

flightRecords[].departure.diversion.original.airport.iataCode

String

3-character airport IATA code e.g JFK

flightRecords[].departure.diversion.original.airport.icaoCode

String

4-character airport ICAO code e.g KJFK

flightRecords[].departure.diversion.original.airport.name

String

The name of the airport e.g John F Kennedy International Airport

flightRecords[].departure.diversion.original.flightNumber

String

Diversion flight original flight number

flightRecords[].departure.diversion.original.iataCode

String

Diversion flight original airline iata code

flightRecords[].departure.diversion.original.icaoCode

String

Diversion flight original airline icao code

flightRecords[].departure.diversion.original.name

String

Diversion flight original airline name

flightRecords[].departure.diversion.original.scheduled

String

Diversion flight original scheduled date of operation

flightRecords[].departure.diversion.recovery

Object

Flight Diversion recovery record

flightRecords[].departure.diversion.recovery.airport

Object

Airport

flightRecords[].departure.diversion.recovery.airport.city

String

The city in which the airport is located e.g New York

flightRecords[].departure.diversion.recovery.airport.cityText

String

The city in which the airport is located e.g New York

flightRecords[].departure.diversion.recovery.airport.iataCode

String

3-character airport IATA code e.g JFK

flightRecords[].departure.diversion.recovery.airport.icaoCode

String

4-character airport ICAO code e.g KJFK

flightRecords[].departure.diversion.recovery.airport.name

String

The name of the airport e.g John F Kennedy International Airport

flightRecords[].departure.diversion.recovery.flightNumber

String

Diversion flight recovery flight number

flightRecords[].departure.diversion.recovery.iataCode

String

Diversion flight recovery airline iata code

flightRecords[].departure.diversion.recovery.icaoCode

String

Diversion flight recovery airline icao code

flightRecords[].departure.diversion.recovery.name

String

Diversion flight recovery airline name

flightRecords[].departure.diversion.recovery.scheduled

String

Diversion flight recovery scheduled date of operation

flightRecords[].departure.estimated

String

The latest estimated local departure/arrival time for this flight e.g 2020-01-22T12:00:00+03:00

flightRecords[].departure.events

Object

Flight events.

flightRecords[].departure.events.AIBT

String

The actual local time at which the aircraft arrived at the gate

flightRecords[].departure.events.ALDT

String

The actual local time at which the aircraft landed on the runway

flightRecords[].departure.events.AOBT

String

The actual local time at which the aircraft left the gate

flightRecords[].departure.events.ATOT

String

The actual local time at which the aircraft left the runway

flightRecords[].departure.events.EIBT

String

The estimated local time at which the aircraft is expected at the gate

flightRecords[].departure.events.ELDT

String

The estimated local time at which the aircraft is expected to land on the runway

flightRecords[].departure.events.EOBT

String

The estimated local time at which the aircraft is expected to leave the gate

flightRecords[].departure.events.ETOT

String

The estimated local time at which the aircraft is expected to leave the runway

flightRecords[].departure.events.TOBT

String

The local time at which the aircraft is targeted to leave the gate

flightRecords[].departure.events.TTOT

String

The local time at which the aircraft is targeted to leave the runway

flightRecords[].departure.gate

String

The flights departure/arrival gate e.g C1

flightRecords[].departure.gateRemark

String

Departure gate remark

flightRecords[].departure.gateRemarkText

String

Gate remark text when applicable e.g Boarding at 21:00

flightRecords[].departure.gateSlots[]

Array

Gate Slots

flightRecords[].departure.gateSlots[].area

String

Location details of the slot resource i.e check-in desks1-20, Gate 2C etc

flightRecords[].departure.gateSlots[].endTime

String

End time for the slot activity e.g check-in desk closed

flightRecords[].departure.gateSlots[].externalName

String

Name used to identify the slot

flightRecords[].departure.gateSlots[].name

String

Name used to identify the slot internally

flightRecords[].departure.gateSlots[].startTime

String

Start time for the slot activity e.g check-in desk opened

flightRecords[].departure.route[]

Array

Route

flightRecords[].departure.route[].iataCode

String

3-character airport IATA code

flightRecords[].departure.route[].icaoCode

String

4-character airport ICAO code

flightRecords[].departure.route[].sequenceNumber

String

Value used to identify the routes position within an entire flight route e.g leg 0, leg 1, leg 2 etc

flightRecords[].departure.scheduled

String

The published scheduled local departure/arrival time for this flight e.g 2020-01-22T12:00:00+03:00

flightRecords[].departure.stand

String

Aircraft stand details e.g S12

flightRecords[].departure.standSlots[]

Array

Stand Slots

flightRecords[].departure.standSlots[].area

String

Location details of the slot resource i.e check-in desks1-20, Gate 2C etc

flightRecords[].departure.standSlots[].endTime

String

End time for the slot activity e.g check-in desk closed

flightRecords[].departure.standSlots[].externalName

String

Name used to identify the slot

flightRecords[].departure.standSlots[].name

String

Name used to identify the slot internally

flightRecords[].departure.standSlots[].startTime

String

Start time for the slot activity e.g check-in desk opened

flightRecords[].departure.status

String

The current status code for this flight e.g SC, DP

flightRecords[].departure.statusText

String

The current status text for this flight e.g Scheduled, Departed

flightRecords[].departure.terminal

String

The flights departure/arrival terminal e.g T1

flightRecords[].departure.updates[]

Array

Updates

flightRecords[].departure.updates[].current

String

Current field value

flightRecords[].departure.updates[].previous

String

Previous field value

flightRecords[].departure.updates[].received

String

UTC timestamp when update was applied

flightRecords[].departure.updates[].updatedField

Object

Payload field which was updated

flightRecords[].departure.version

Number

FLIFO internal version number

flightRecords[].duration

String

Flight duration in minutes e.g 60

flightRecords[].flightIdentifier

Object

Flight Identifier

flightRecords[].flightIdentifier.aircraft

Object

Aircraft

flightRecords[].flightIdentifier.aircraft.callSign

String

Callsign for the aircraft type

flightRecords[].flightIdentifier.aircraft.iataCode

String

IATA code for the aircraft

flightRecords[].flightIdentifier.aircraft.icaoCode

String

ICAO code for the aircraft

flightRecords[].flightIdentifier.aircraft.model

String

Specific aircraft model details

flightRecords[].flightIdentifier.aircraft.registration

String

Aircraft regristration/tail number details e.g EIAA44W

flightRecords[].flightIdentifier.flightId

String

A value that uniquely identifies a flight within the system

flightRecords[].flightIdentifier.marketingCarriers[]

Array

Marketing Carriers

flightRecords[].flightIdentifier.marketingCarriers[].flightNumber

String

Flight number e.g 1234

flightRecords[].flightIdentifier.marketingCarriers[].iataCode

String

2-character airline IATA code e.g AA

flightRecords[].flightIdentifier.marketingCarriers[].icaoCode

String

3-character airline ICAO code e.g AAL

flightRecords[].flightIdentifier.marketingCarriers[].name

String

Name of airline e.g American Airlines

flightRecords[].flightIdentifier.operatingCarrier

Object

Operating Carrier

flightRecords[].flightIdentifier.operatingCarrier.flightNumber

String

Flight number e.g 1234

flightRecords[].flightIdentifier.operatingCarrier.iataCode

String

2-character airline IATA code e.g AA

flightRecords[].flightIdentifier.operatingCarrier.icaoCode

String

3-character airline ICAO code e.g AAL

flightRecords[].flightIdentifier.operatingCarrier.name

String

Name of airline e.g American Airlines

flightRecords[].flightStats

Object

Flight Stats

flightRecords[].flightStats.baggage

Object

Baggage

flightRecords[].flightStats.baggage.cargo

String

Total number of cargo pieces

flightRecords[].flightStats.baggage.count

String

Total number of bags/pieces

flightRecords[].flightStats.baggage.load

String

Load breakdown

flightRecords[].flightStats.baggage.mail

String

Total number of mail pieces

flightRecords[].flightStats.baggage.totalWeight

String

Total weight of bags/pieces

flightRecords[].flightStats.passengers

Object

Passengers

flightRecords[].flightStats.passengers.actualBusiness

String

Actual number of business class passengers

flightRecords[].flightStats.passengers.actualEconomy

String

Actual number of economy class passengers

flightRecords[].flightStats.passengers.actualFirst

String

Actual number of 1st class passengers

flightRecords[].flightStats.passengers.actualTotal

String

Actual number of passengers

flightRecords[].flightStats.passengers.actualTransfer

String

Actual number of transfer passengers

flightRecords[].flightStats.passengers.actualTransit

String

Actual number of transit passengers

flightRecords[].flightStats.passengers.adult

String

Total number of adults

flightRecords[].flightStats.passengers.bookedBusiness

String

Total number of booked business class passengers

flightRecords[].flightStats.passengers.bookedEconomy

String

Total number of booked economy class passengers

flightRecords[].flightStats.passengers.bookedFirst

String

Total number of booked 1st class passengers

flightRecords[].flightStats.passengers.bookedTotal

String

Total number of booked passengers

flightRecords[].flightStats.passengers.child

String

Total number of children

flightRecords[].flightStats.passengers.infant

String

Total number of infants

flightRecords[].flightStats.passengers.reducedMobility

String

Total number of reduced mobility passengers e.g those requiring assistance boarding the aircraft etc.

flightRecords[].metadata.lastUpdateTime

String

UTC timestamp when last update update was applied to this flight

flightRecords[].metadata.provider

String

Data source of the last update applied to this flight

flightRecords[].serviceType

String

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
/flightinfo/v2/flights/airport/{airportCode}/direction/{direction}
ParameterDescription

airportCode

3-character airport IATA code or 4-character airport ICAO code

direction

1-character direction indicator (A/D)

Query parameters
ParameterDescription

operationDate

Local date/datetime of operation (yyyy-MM-dd or yyyy-MM-ddTHH:mm:ss). Default value is current UTC date

pastWindow

Hours in past to return. Default value is 0

futureWindow

Hours in future to return. Default value is 4

searchByUTC

Search based by UTC. Default value is false

showCargo

Include cargo flights. Default value is false

groupMarketingCarriers

Group marketing and operating carrier flights into a single record. Default value is false

departureOrArrivalAirport

Filter results based on origin or destination airport

view

View 'full' or 'local' leg, based on direction. Default value is local. See notes for further details.

Request headers
NameOptionalDescription

Content-Type

false

Content type of this request. Required value is 'application/json'

Authorization

false

Authorization header that contains the access token.

Response fields
PathTypeDescription

flightRecords[]

Array

Flight Records

flightRecords[].arrival

Object

Arrival

flightRecords[].arrival.actual

String

The actual local departure/arrival time for this flight e.g 2020-01-22T12:00:00+03:00

flightRecords[].arrival.airport

Object

Airport

flightRecords[].arrival.airport.city

String

The city in which the airport is located e.g New York

flightRecords[].arrival.airport.cityText

String

The city in which the airport is located e.g New York

flightRecords[].arrival.airport.iataCode

String

3-character airport IATA code e.g JFK

flightRecords[].arrival.airport.icaoCode

String

4-character airport ICAO code e.g KJFK

flightRecords[].arrival.airport.name

String

The name of the airport e.g John F Kennedy International Airport

flightRecords[].arrival.carousel

String

Expected carousel(s) for baggage reclaim

flightRecords[].arrival.carouselSlots[]

Array

Carousel Slots

flightRecords[].arrival.carouselSlots[].area

String

Location details of the slot resource i.e check-in desks1-20, Gate 2C etc

flightRecords[].arrival.carouselSlots[].endTime

String

End time for the slot activity e.g check-in desk closed

flightRecords[].arrival.carouselSlots[].externalName

String

Name used to identify the slot

flightRecords[].arrival.carouselSlots[].name

String

Name used to identify the slot internally

flightRecords[].arrival.carouselSlots[].startTime

String

Start time for the slot activity e.g check-in desk opened

flightRecords[].arrival.checkIn

String

Check-in desk details e.g CK-1

flightRecords[].arrival.checkinSlots[]

Array

Checkin Slots

flightRecords[].arrival.checkinSlots[].area

String

Location details of the slot resource i.e check-in desks1-20, Gate 2C etc

flightRecords[].arrival.checkinSlots[].endTime

String

End time for the slot activity e.g check-in desk closed

flightRecords[].arrival.checkinSlots[].externalName

String

Name used to identify the slot

flightRecords[].arrival.checkinSlots[].name

String

Name used to identify the slot internally

flightRecords[].arrival.checkinSlots[].startTime

String

Start time for the slot activity e.g check-in desk opened

flightRecords[].arrival.chute

String

Baggage chute details e.g CH-2

flightRecords[].arrival.chuteSlots[]

Array

Chute Slots

flightRecords[].arrival.chuteSlots[].area

String

Location details of the slot resource i.e check-in desks1-20, Gate 2C etc

flightRecords[].arrival.chuteSlots[].endTime

String

End time for the slot activity e.g check-in desk closed

flightRecords[].arrival.chuteSlots[].externalName

String

Name used to identify the slot

flightRecords[].arrival.chuteSlots[].name

String

Name used to identify the slot internally

flightRecords[].arrival.chuteSlots[].startTime

String

Start time for the slot activity e.g check-in desk opened

flightRecords[].arrival.customProperties[]

Array

Custom Properties

flightRecords[].arrival.customProperties[].key

String

Key value used to identify a custom property

flightRecords[].arrival.customProperties[].value

String

The value of a custom property

flightRecords[].arrival.diversion

Object

Flight Diversion Details.

flightRecords[].arrival.diversion.original

Object

Flight Diversion original record

flightRecords[].arrival.diversion.original.airport

Object

Airport

flightRecords[].arrival.diversion.original.airport.city

String

The city in which the airport is located e.g New York

flightRecords[].arrival.diversion.original.airport.cityText

String

The city in which the airport is located e.g New York

flightRecords[].arrival.diversion.original.airport.iataCode

String

3-character airport IATA code e.g JFK

flightRecords[].arrival.diversion.original.airport.icaoCode

String

4-character airport ICAO code e.g KJFK

flightRecords[].arrival.diversion.original.airport.name

String

The name of the airport e.g John F Kennedy International Airport

flightRecords[].arrival.diversion.original.flightNumber

String

Diversion flight original flight number

flightRecords[].arrival.diversion.original.iataCode

String

Diversion flight original airline iata code

flightRecords[].arrival.diversion.original.icaoCode

String

Diversion flight original airline icao code

flightRecords[].arrival.diversion.original.name

String

Diversion flight original airline name

flightRecords[].arrival.diversion.original.scheduled

String

Diversion flight original scheduled date of operation

flightRecords[].arrival.diversion.recovery

Object

Flight Diversion recovery record

flightRecords[].arrival.diversion.recovery.airport

Object

Airport

flightRecords[].arrival.diversion.recovery.airport.city

String

The city in which the airport is located e.g New York

flightRecords[].arrival.diversion.recovery.airport.cityText

String

The city in which the airport is located e.g New York

flightRecords[].arrival.diversion.recovery.airport.iataCode

String

3-character airport IATA code e.g JFK

flightRecords[].arrival.diversion.recovery.airport.icaoCode

String

4-character airport ICAO code e.g KJFK

flightRecords[].arrival.diversion.recovery.airport.name

String

The name of the airport e.g John F Kennedy International Airport

flightRecords[].arrival.diversion.recovery.flightNumber

String

Diversion flight recovery flight number

flightRecords[].arrival.diversion.recovery.iataCode

String

Diversion flight recovery airline iata code

flightRecords[].arrival.diversion.recovery.icaoCode

String

Diversion flight recovery airline icao code

flightRecords[].arrival.diversion.recovery.name

String

Diversion flight recovery airline name

flightRecords[].arrival.diversion.recovery.scheduled

String

Diversion flight recovery scheduled date of operation

flightRecords[].arrival.estimated

String

The latest estimated local departure/arrival time for this flight e.g 2020-01-22T12:00:00+03:00

flightRecords[].arrival.events

Object

Flight events.

flightRecords[].arrival.events.AIBT

String

The actual local time at which the aircraft arrived at the gate

flightRecords[].arrival.events.ALDT

String

The actual local time at which the aircraft landed on the runway

flightRecords[].arrival.events.AOBT

String

The actual local time at which the aircraft left the gate

flightRecords[].arrival.events.ATOT

String

The actual local time at which the aircraft left the runway

flightRecords[].arrival.events.EIBT

String

The estimated local time at which the aircraft is expected at the gate

flightRecords[].arrival.events.ELDT

String

The estimated local time at which the aircraft is expected to land on the runway

flightRecords[].arrival.events.EOBT

String

The estimated local time at which the aircraft is expected to leave the gate

flightRecords[].arrival.events.ETOT

String

The estimated local time at which the aircraft is expected to leave the runway

flightRecords[].arrival.events.TOBT

String

The local time at which the aircraft is targeted to leave the gate

flightRecords[].arrival.events.TTOT

String

The local time at which the aircraft is targeted to leave the runway

flightRecords[].arrival.gate

String

The flights departure/arrival gate e.g C1

flightRecords[].arrival.gateRemark

String

Arrival gate remark

flightRecords[].arrival.gateRemarkText

String

Gate remark text when applicable e.g Boarding at 21:00

flightRecords[].arrival.gateSlots[]

Array

Gate Slots

flightRecords[].arrival.gateSlots[].area

String

Location details of the slot resource i.e check-in desks1-20, Gate 2C etc

flightRecords[].arrival.gateSlots[].endTime

String

End time for the slot activity e.g check-in desk closed

flightRecords[].arrival.gateSlots[].externalName

String

Name used to identify the slot

flightRecords[].arrival.gateSlots[].name

String

Name used to identify the slot internally

flightRecords[].arrival.gateSlots[].startTime

String

Start time for the slot activity e.g check-in desk opened

flightRecords[].arrival.route[]

Array

Route

flightRecords[].arrival.route[].iataCode

String

3-character airport IATA code

flightRecords[].arrival.route[].icaoCode

String

4-character airport ICAO code

flightRecords[].arrival.route[].sequenceNumber

String

Value used to identify the routes position within an entire flight route e.g leg 0, leg 1, leg 2 etc

flightRecords[].arrival.scheduled

String

The published scheduled local departure/arrival time for this flight e.g 2020-01-22T12:00:00+03:00

flightRecords[].arrival.stand

String

Aircraft stand details e.g S12

flightRecords[].arrival.standSlots[]

Array

Stand Slots

flightRecords[].arrival.standSlots[].area

String

Location details of the slot resource i.e check-in desks1-20, Gate 2C etc

flightRecords[].arrival.standSlots[].endTime

String

End time for the slot activity e.g check-in desk closed

flightRecords[].arrival.standSlots[].externalName

String

Name used to identify the slot

flightRecords[].arrival.standSlots[].name

String

Name used to identify the slot internally

flightRecords[].arrival.standSlots[].startTime

String

Start time for the slot activity e.g check-in desk opened

flightRecords[].arrival.status

String

The current status code for this flight e.g SC, DP

flightRecords[].arrival.statusText

String

The current status text for this flight e.g Scheduled, Departed

flightRecords[].arrival.terminal

String

The flights departure/arrival terminal e.g T1

flightRecords[].arrival.updates[]

Array

Updates

flightRecords[].arrival.updates[].current

String

Current field value

flightRecords[].arrival.updates[].previous

String

Previous field value

flightRecords[].arrival.updates[].received

String

UTC timestamp when update was applied

flightRecords[].arrival.updates[].updatedField

Object

Payload field which was updated

flightRecords[].arrival.version

Number

FLIFO internal version number

flightRecords[].departure

Object

Departure

flightRecords[].departure.actual

String

The actual local departure/arrival time for this flight e.g 2020-01-22T12:00:00+03:00

flightRecords[].departure.airport

Object

Airport

flightRecords[].departure.airport.city

String

The city in which the airport is located e.g New York

flightRecords[].departure.airport.cityText

String

The city in which the airport is located e.g New York

flightRecords[].departure.airport.iataCode

String

3-character airport IATA code e.g JFK

flightRecords[].departure.airport.icaoCode

String

4-character airport ICAO code e.g KJFK

flightRecords[].departure.airport.name

String

The name of the airport e.g John F Kennedy International Airport

flightRecords[].departure.carousel

String

Expected carousel(s) for baggage reclaim

flightRecords[].departure.carouselSlots[]

Array

Carousel Slots

flightRecords[].departure.carouselSlots[].area

String

Location details of the slot resource i.e check-in desks1-20, Gate 2C etc

flightRecords[].departure.carouselSlots[].endTime

String

End time for the slot activity e.g check-in desk closed

flightRecords[].departure.carouselSlots[].externalName

String

Name used to identify the slot

flightRecords[].departure.carouselSlots[].name

String

Name used to identify the slot internally

flightRecords[].departure.carouselSlots[].startTime

String

Start time for the slot activity e.g check-in desk opened

flightRecords[].departure.checkIn

String

Check-in desk details e.g CK-1

flightRecords[].departure.checkinSlots[]

Array

Checkin Slots

flightRecords[].departure.checkinSlots[].area

String

Location details of the slot resource i.e check-in desks1-20, Gate 2C etc

flightRecords[].departure.checkinSlots[].endTime

String

End time for the slot activity e.g check-in desk closed

flightRecords[].departure.checkinSlots[].externalName

String

Name used to identify the slot

flightRecords[].departure.checkinSlots[].name

String

Name used to identify the slot internally

flightRecords[].departure.checkinSlots[].startTime

String

Start time for the slot activity e.g check-in desk opened

flightRecords[].departure.chute

String

Baggage chute details e.g CH-2

flightRecords[].departure.chuteSlots[]

Array

Chute Slots

flightRecords[].departure.chuteSlots[].area

String

Location details of the slot resource i.e check-in desks1-20, Gate 2C etc

flightRecords[].departure.chuteSlots[].endTime

String

End time for the slot activity e.g check-in desk closed

flightRecords[].departure.chuteSlots[].externalName

String

Name used to identify the slot

flightRecords[].departure.chuteSlots[].name

String

Name used to identify the slot internally

flightRecords[].departure.chuteSlots[].startTime

String

Start time for the slot activity e.g check-in desk opened

flightRecords[].departure.customProperties[]

Array

Custom Properties

flightRecords[].departure.customProperties[].key

String

Key value used to identify a custom property

flightRecords[].departure.customProperties[].value

String

The value of a custom property

flightRecords[].departure.diversion

Object

Flight Diversion Details.

flightRecords[].departure.diversion.original

Object

Flight Diversion original record

flightRecords[].departure.diversion.original.airport

Object

Airport

flightRecords[].departure.diversion.original.airport.city

String

The city in which the airport is located e.g New York

flightRecords[].departure.diversion.original.airport.cityText

String

The city in which the airport is located e.g New York

flightRecords[].departure.diversion.original.airport.iataCode

String

3-character airport IATA code e.g JFK

flightRecords[].departure.diversion.original.airport.icaoCode

String

4-character airport ICAO code e.g KJFK

flightRecords[].departure.diversion.original.airport.name

String

The name of the airport e.g John F Kennedy International Airport

flightRecords[].departure.diversion.original.flightNumber

String

Diversion flight original flight number

flightRecords[].departure.diversion.original.iataCode

String

Diversion flight original airline iata code

flightRecords[].departure.diversion.original.icaoCode

String

Diversion flight original airline icao code

flightRecords[].departure.diversion.original.name

String

Diversion flight original airline name

flightRecords[].departure.diversion.original.scheduled

String

Diversion flight original scheduled date of operation

flightRecords[].departure.diversion.recovery

Object

Flight Diversion recovery record

flightRecords[].departure.diversion.recovery.airport

Object

Airport

flightRecords[].departure.diversion.recovery.airport.city

String

The city in which the airport is located e.g New York

flightRecords[].departure.diversion.recovery.airport.cityText

String

The city in which the airport is located e.g New York

flightRecords[].departure.diversion.recovery.airport.iataCode

String

3-character airport IATA code e.g JFK

flightRecords[].departure.diversion.recovery.airport.icaoCode

String

4-character airport ICAO code e.g KJFK

flightRecords[].departure.diversion.recovery.airport.name

String

The name of the airport e.g John F Kennedy International Airport

flightRecords[].departure.diversion.recovery.flightNumber

String

Diversion flight recovery flight number

flightRecords[].departure.diversion.recovery.iataCode

String

Diversion flight recovery airline iata code

flightRecords[].departure.diversion.recovery.icaoCode

String

Diversion flight recovery airline icao code

flightRecords[].departure.diversion.recovery.name

String

Diversion flight recovery airline name

flightRecords[].departure.diversion.recovery.scheduled

String

Diversion flight recovery scheduled date of operation

flightRecords[].departure.estimated

String

The latest estimated local departure/arrival time for this flight e.g 2020-01-22T12:00:00+03:00

flightRecords[].departure.events

Object

Flight events.

flightRecords[].departure.events.AIBT

String

The actual local time at which the aircraft arrived at the gate

flightRecords[].departure.events.ALDT

String

The actual local time at which the aircraft landed on the runway

flightRecords[].departure.events.AOBT

String

The actual local time at which the aircraft left the gate

flightRecords[].departure.events.ATOT

String

The actual local time at which the aircraft left the runway

flightRecords[].departure.events.EIBT

String

The estimated local time at which the aircraft is expected at the gate

flightRecords[].departure.events.ELDT

String

The estimated local time at which the aircraft is expected to land on the runway

flightRecords[].departure.events.EOBT

String

The estimated local time at which the aircraft is expected to leave the gate

flightRecords[].departure.events.ETOT

String

The estimated local time at which the aircraft is expected to leave the runway

flightRecords[].departure.events.TOBT

String

The local time at which the aircraft is targeted to leave the gate

flightRecords[].departure.events.TTOT

String

The local time at which the aircraft is targeted to leave the runway

flightRecords[].departure.gate

String

The flights departure/arrival gate e.g C1

flightRecords[].departure.gateRemark

String

Departure gate remark

flightRecords[].departure.gateRemarkText

String

Gate remark text when applicable e.g Boarding at 21:00

flightRecords[].departure.gateSlots[]

Array

Gate Slots

flightRecords[].departure.gateSlots[].area

String

Location details of the slot resource i.e check-in desks1-20, Gate 2C etc

flightRecords[].departure.gateSlots[].endTime

String

End time for the slot activity e.g check-in desk closed

flightRecords[].departure.gateSlots[].externalName

String

Name used to identify the slot

flightRecords[].departure.gateSlots[].name

String

Name used to identify the slot internally

flightRecords[].departure.gateSlots[].startTime

String

Start time for the slot activity e.g check-in desk opened

flightRecords[].departure.route[]

Array

Route

flightRecords[].departure.route[].iataCode

String

3-character airport IATA code

flightRecords[].departure.route[].icaoCode

String

4-character airport ICAO code

flightRecords[].departure.route[].sequenceNumber

String

Value used to identify the routes position within an entire flight route e.g leg 0, leg 1, leg 2 etc

flightRecords[].departure.scheduled

String

The published scheduled local departure/arrival time for this flight e.g 2020-01-22T12:00:00+03:00

flightRecords[].departure.stand

String

Aircraft stand details e.g S12

flightRecords[].departure.standSlots[]

Array

Stand Slots

flightRecords[].departure.standSlots[].area

String

Location details of the slot resource i.e check-in desks1-20, Gate 2C etc

flightRecords[].departure.standSlots[].endTime

String

End time for the slot activity e.g check-in desk closed

flightRecords[].departure.standSlots[].externalName

String

Name used to identify the slot

flightRecords[].departure.standSlots[].name

String

Name used to identify the slot internally

flightRecords[].departure.standSlots[].startTime

String

Start time for the slot activity e.g check-in desk opened

flightRecords[].departure.status

String

The current status code for this flight e.g SC, DP

flightRecords[].departure.statusText

String

The current status text for this flight e.g Scheduled, Departed

flightRecords[].departure.terminal

String

The flights departure/arrival terminal e.g T1

flightRecords[].departure.updates[]

Array

Updates

flightRecords[].departure.updates[].current

String

Current field value

flightRecords[].departure.updates[].previous

String

Previous field value

flightRecords[].departure.updates[].received

String

UTC timestamp when update was applied

flightRecords[].departure.updates[].updatedField

Object

Payload field which was updated

flightRecords[].departure.version

Number

FLIFO internal version number

flightRecords[].duration

String

Flight duration in minutes e.g 60

flightRecords[].flightIdentifier

Object

Flight Identifier

flightRecords[].flightIdentifier.aircraft

Object

Aircraft

flightRecords[].flightIdentifier.aircraft.callSign

String

Callsign for the aircraft type

flightRecords[].flightIdentifier.aircraft.iataCode

String

IATA code for the aircraft

flightRecords[].flightIdentifier.aircraft.icaoCode

String

ICAO code for the aircraft

flightRecords[].flightIdentifier.aircraft.model

String

Specific aircraft model details

flightRecords[].flightIdentifier.aircraft.registration

String

Aircraft regristration/tail number details e.g EIAA44W

flightRecords[].flightIdentifier.flightId

String

A value that uniquely identifies a flight within the system

flightRecords[].flightIdentifier.marketingCarriers[]

Array

Marketing Carriers

flightRecords[].flightIdentifier.marketingCarriers[].flightNumber

String

Flight number e.g 1234

flightRecords[].flightIdentifier.marketingCarriers[].iataCode

String

2-character airline IATA code e.g AA

flightRecords[].flightIdentifier.marketingCarriers[].icaoCode

String

3-character airline ICAO code e.g AAL

flightRecords[].flightIdentifier.marketingCarriers[].name

String

Name of airline e.g American Airlines

flightRecords[].flightIdentifier.operatingCarrier

Object

Operating Carrier

flightRecords[].flightIdentifier.operatingCarrier.flightNumber

String

Flight number e.g 1234

flightRecords[].flightIdentifier.operatingCarrier.iataCode

String

2-character airline IATA code e.g AA

flightRecords[].flightIdentifier.operatingCarrier.icaoCode

String

3-character airline ICAO code e.g AAL

flightRecords[].flightIdentifier.operatingCarrier.name

String

Name of airline e.g American Airlines

flightRecords[].flightStats

Object

Flight Stats

flightRecords[].flightStats.baggage

Object

Baggage

flightRecords[].flightStats.baggage.cargo

String

Total number of cargo pieces

flightRecords[].flightStats.baggage.count

String

Total number of bags/pieces

flightRecords[].flightStats.baggage.load

String

Load breakdown

flightRecords[].flightStats.baggage.mail

String

Total number of mail pieces

flightRecords[].flightStats.baggage.totalWeight

String

Total weight of bags/pieces

flightRecords[].flightStats.passengers

Object

Passengers

flightRecords[].flightStats.passengers.actualBusiness

String

Actual number of business class passengers

flightRecords[].flightStats.passengers.actualEconomy

String

Actual number of economy class passengers

flightRecords[].flightStats.passengers.actualFirst

String

Actual number of 1st class passengers

flightRecords[].flightStats.passengers.actualTotal

String

Actual number of passengers

flightRecords[].flightStats.passengers.actualTransfer

String

Actual number of transfer passengers

flightRecords[].flightStats.passengers.actualTransit

String

Actual number of transit passengers

flightRecords[].flightStats.passengers.adult

String

Total number of adults

flightRecords[].flightStats.passengers.bookedBusiness

String

Total number of booked business class passengers

flightRecords[].flightStats.passengers.bookedEconomy

String

Total number of booked economy class passengers

flightRecords[].flightStats.passengers.bookedFirst

String

Total number of booked 1st class passengers

flightRecords[].flightStats.passengers.bookedTotal

String

Total number of booked passengers

flightRecords[].flightStats.passengers.child

String

Total number of children

flightRecords[].flightStats.passengers.infant

String

Total number of infants

flightRecords[].flightStats.passengers.reducedMobility

String

Total number of reduced mobility passengers e.g those requiring assistance boarding the aircraft etc.

flightRecords[].metadata.lastUpdateTime

String

UTC timestamp when last update update was applied to this flight

flightRecords[].metadata.provider

String

Data source of the last update applied to this flight

flightRecords[].serviceType

String

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
/flightinfo/v2/flights/updates/airport/{airportCode}/airline/{airlineCode}/flightNumber/{flightNumber}
ParameterDescription

airportCode

3-character airport IATA code or 4-character airport ICAO code

airlineCode

2-character airline IATA code or 3-character airline ICAO code

flightNumber

Flight number

Query parameters
ParameterDescription

operationDate

Local date of operation (yyyy-MM-dd). Default value is current UTC date

from

Date interval start e.g 2020-01-01T12:00:00-0000. Default is current UTC date/time - 2 minutes

to

Date interval end e.g 2020-01-01T12:05:00-0000. Default is current UTC date/time - 1 minutes

includeUpdates

Show updated fields

groupMarketingCarriers

Group marketing and operating carrier flights into a single record. Default value is false

groupRecords

Group updates in a single record

verbose

Show additional information such as version

showCargo

Include cargo flights. Default value is false

Request headers
NameOptionalDescription

Content-Type

false

Content type of this request. Required value is 'application/json'

Authorization

false

Authorization header that contains the access token.

Response fields
PathTypeDescription

flightRecords[]

Array

Flight Records

flightRecords[].arrival

Object

Arrival

flightRecords[].arrival.actual

String

The actual local departure/arrival time for this flight e.g 2020-01-22T12:00:00+03:00

flightRecords[].arrival.airport

Object

Airport

flightRecords[].arrival.airport.city

String

The city in which the airport is located e.g New York

flightRecords[].arrival.airport.cityText

String

The city in which the airport is located e.g New York

flightRecords[].arrival.airport.iataCode

String

3-character airport IATA code e.g JFK

flightRecords[].arrival.airport.icaoCode

String

4-character airport ICAO code e.g KJFK

flightRecords[].arrival.airport.name

String

The name of the airport e.g John F Kennedy International Airport

flightRecords[].arrival.carousel

String

Expected carousel(s) for baggage reclaim

flightRecords[].arrival.carouselSlots[]

Array

Carousel Slots

flightRecords[].arrival.carouselSlots[].area

String

Location details of the slot resource i.e check-in desks1-20, Gate 2C etc

flightRecords[].arrival.carouselSlots[].endTime

String

End time for the slot activity e.g check-in desk closed

flightRecords[].arrival.carouselSlots[].externalName

String

Name used to identify the slot

flightRecords[].arrival.carouselSlots[].name

String

Name used to identify the slot internally

flightRecords[].arrival.carouselSlots[].startTime

String

Start time for the slot activity e.g check-in desk opened

flightRecords[].arrival.checkIn

String

Check-in desk details e.g CK-1

flightRecords[].arrival.checkinSlots[]

Array

Checkin Slots

flightRecords[].arrival.checkinSlots[].area

String

Location details of the slot resource i.e check-in desks1-20, Gate 2C etc

flightRecords[].arrival.checkinSlots[].endTime

String

End time for the slot activity e.g check-in desk closed

flightRecords[].arrival.checkinSlots[].externalName

String

Name used to identify the slot

flightRecords[].arrival.checkinSlots[].name

String

Name used to identify the slot internally

flightRecords[].arrival.checkinSlots[].startTime

String

Start time for the slot activity e.g check-in desk opened

flightRecords[].arrival.chute

String

Baggage chute details e.g CH-2

flightRecords[].arrival.chuteSlots[]

Array

Chute Slots

flightRecords[].arrival.chuteSlots[].area

String

Location details of the slot resource i.e check-in desks1-20, Gate 2C etc

flightRecords[].arrival.chuteSlots[].endTime

String

End time for the slot activity e.g check-in desk closed

flightRecords[].arrival.chuteSlots[].externalName

String

Name used to identify the slot

flightRecords[].arrival.chuteSlots[].name

String

Name used to identify the slot internally

flightRecords[].arrival.chuteSlots[].startTime

String

Start time for the slot activity e.g check-in desk opened

flightRecords[].arrival.customProperties[]

Array

Custom Properties

flightRecords[].arrival.customProperties[].key

String

Key value used to identify a custom property

flightRecords[].arrival.customProperties[].value

String

The value of a custom property

flightRecords[].arrival.diversion

Object

Flight Diversion Details.

flightRecords[].arrival.diversion.original

Object

Flight Diversion original record

flightRecords[].arrival.diversion.original.airport

Object

Airport

flightRecords[].arrival.diversion.original.airport.city

String

The city in which the airport is located e.g New York

flightRecords[].arrival.diversion.original.airport.cityText

String

The city in which the airport is located e.g New York

flightRecords[].arrival.diversion.original.airport.iataCode

String

3-character airport IATA code e.g JFK

flightRecords[].arrival.diversion.original.airport.icaoCode

String

4-character airport ICAO code e.g KJFK

flightRecords[].arrival.diversion.original.airport.name

String

The name of the airport e.g John F Kennedy International Airport

flightRecords[].arrival.diversion.original.flightNumber

String

Diversion flight original flight number

flightRecords[].arrival.diversion.original.iataCode

String

Diversion flight original airline iata code

flightRecords[].arrival.diversion.original.icaoCode

String

Diversion flight original airline icao code

flightRecords[].arrival.diversion.original.name

String

Diversion flight original airline name

flightRecords[].arrival.diversion.original.scheduled

String

Diversion flight original scheduled date of operation

flightRecords[].arrival.diversion.recovery

Object

Flight Diversion recovery record

flightRecords[].arrival.diversion.recovery.airport

Object

Airport

flightRecords[].arrival.diversion.recovery.airport.city

String

The city in which the airport is located e.g New York

flightRecords[].arrival.diversion.recovery.airport.cityText

String

The city in which the airport is located e.g New York

flightRecords[].arrival.diversion.recovery.airport.iataCode

String

3-character airport IATA code e.g JFK

flightRecords[].arrival.diversion.recovery.airport.icaoCode

String

4-character airport ICAO code e.g KJFK

flightRecords[].arrival.diversion.recovery.airport.name

String

The name of the airport e.g John F Kennedy International Airport

flightRecords[].arrival.diversion.recovery.flightNumber

String

Diversion flight recovery flight number

flightRecords[].arrival.diversion.recovery.iataCode

String

Diversion flight recovery airline iata code

flightRecords[].arrival.diversion.recovery.icaoCode

String

Diversion flight recovery airline icao code

flightRecords[].arrival.diversion.recovery.name

String

Diversion flight recovery airline name

flightRecords[].arrival.diversion.recovery.scheduled

String

Diversion flight recovery scheduled date of operation

flightRecords[].arrival.estimated

String

The latest estimated local departure/arrival time for this flight e.g 2020-01-22T12:00:00+03:00

flightRecords[].arrival.events

Object

Flight events.

flightRecords[].arrival.events.AIBT

String

The actual local time at which the aircraft arrived at the gate

flightRecords[].arrival.events.ALDT

String

The actual local time at which the aircraft landed on the runway

flightRecords[].arrival.events.AOBT

String

The actual local time at which the aircraft left the gate

flightRecords[].arrival.events.ATOT

String

The actual local time at which the aircraft left the runway

flightRecords[].arrival.events.EIBT

String

The estimated local time at which the aircraft is expected at the gate

flightRecords[].arrival.events.ELDT

String

The estimated local time at which the aircraft is expected to land on the runway

flightRecords[].arrival.events.EOBT

String

The estimated local time at which the aircraft is expected to leave the gate

flightRecords[].arrival.events.ETOT

String

The estimated local time at which the aircraft is expected to leave the runway

flightRecords[].arrival.events.TOBT

String

The local time at which the aircraft is targeted to leave the gate

flightRecords[].arrival.events.TTOT

String

The local time at which the aircraft is targeted to leave the runway

flightRecords[].arrival.gate

String

The flights departure/arrival gate e.g C1

flightRecords[].arrival.gateRemark

String

Arrival gate remark

flightRecords[].arrival.gateRemarkText

String

Gate remark text when applicable e.g Boarding at 21:00

flightRecords[].arrival.gateSlots[]

Array

Gate Slots

flightRecords[].arrival.gateSlots[].area

String

Location details of the slot resource i.e check-in desks1-20, Gate 2C etc

flightRecords[].arrival.gateSlots[].endTime

String

End time for the slot activity e.g check-in desk closed

flightRecords[].arrival.gateSlots[].externalName

String

Name used to identify the slot

flightRecords[].arrival.gateSlots[].name

String

Name used to identify the slot internally

flightRecords[].arrival.gateSlots[].startTime

String

Start time for the slot activity e.g check-in desk opened

flightRecords[].arrival.route[]

Array

Route

flightRecords[].arrival.route[].iataCode

String

3-character airport IATA code

flightRecords[].arrival.route[].icaoCode

String

4-character airport ICAO code

flightRecords[].arrival.route[].sequenceNumber

String

Value used to identify the routes position within an entire flight route e.g leg 0, leg 1, leg 2 etc

flightRecords[].arrival.scheduled

String

The published scheduled local departure/arrival time for this flight e.g 2020-01-22T12:00:00+03:00

flightRecords[].arrival.stand

String

Aircraft stand details e.g S12

flightRecords[].arrival.standSlots[]

Array

Stand Slots

flightRecords[].arrival.standSlots[].area

String

Location details of the slot resource i.e check-in desks1-20, Gate 2C etc

flightRecords[].arrival.standSlots[].endTime

String

End time for the slot activity e.g check-in desk closed

flightRecords[].arrival.standSlots[].externalName

String

Name used to identify the slot

flightRecords[].arrival.standSlots[].name

String

Name used to identify the slot internally

flightRecords[].arrival.standSlots[].startTime

String

Start time for the slot activity e.g check-in desk opened

flightRecords[].arrival.status

String

The current status code for this flight e.g SC, DP

flightRecords[].arrival.statusText

String

The current status text for this flight e.g Scheduled, Departed

flightRecords[].arrival.terminal

String

The flights departure/arrival terminal e.g T1

flightRecords[].arrival.updates[]

Array

Updates

flightRecords[].arrival.updates[].current

String

Current field value

flightRecords[].arrival.updates[].metadata.lastUpdateTime

String

UTC timestamp when update was applied (only visible when updates are grouped)

flightRecords[].arrival.updates[].metadata.provider

String

Data source of this update (only visible when updates are grouped)

flightRecords[].arrival.updates[].previous

String

Previous field value

flightRecords[].arrival.updates[].received

String

UTC timestamp when update was received

flightRecords[].arrival.updates[].updatedField

Object

Payload field which was updated

flightRecords[].arrival.version

Number

FLIFO internal version number

flightRecords[].departure

Object

Departure

flightRecords[].departure.actual

String

The actual local departure/arrival time for this flight e.g 2020-01-22T12:00:00+03:00

flightRecords[].departure.airport

Object

Airport

flightRecords[].departure.airport.city

String

The city in which the airport is located e.g New York

flightRecords[].departure.airport.cityText

String

The city in which the airport is located e.g New York

flightRecords[].departure.airport.iataCode

String

3-character airport IATA code e.g JFK

flightRecords[].departure.airport.icaoCode

String

4-character airport ICAO code e.g KJFK

flightRecords[].departure.airport.name

String

The name of the airport e.g John F Kennedy International Airport

flightRecords[].departure.carousel

String

Expected carousel(s) for baggage reclaim

flightRecords[].departure.carouselSlots[]

Array

Carousel Slots

flightRecords[].departure.carouselSlots[].area

String

Location details of the slot resource i.e check-in desks1-20, Gate 2C etc

flightRecords[].departure.carouselSlots[].endTime

String

End time for the slot activity e.g check-in desk closed

flightRecords[].departure.carouselSlots[].externalName

String

Name used to identify the slot

flightRecords[].departure.carouselSlots[].name

String

Name used to identify the slot internally

flightRecords[].departure.carouselSlots[].startTime

String

Start time for the slot activity e.g check-in desk opened

flightRecords[].departure.checkIn

String

Check-in desk details e.g CK-1

flightRecords[].departure.checkinSlots[]

Array

Checkin Slots

flightRecords[].departure.checkinSlots[].area

String

Location details of the slot resource i.e check-in desks1-20, Gate 2C etc

flightRecords[].departure.checkinSlots[].endTime

String

End time for the slot activity e.g check-in desk closed

flightRecords[].departure.checkinSlots[].externalName

String

Name used to identify the slot

flightRecords[].departure.checkinSlots[].name

String

Name used to identify the slot internally

flightRecords[].departure.checkinSlots[].startTime

String

Start time for the slot activity e.g check-in desk opened

flightRecords[].departure.chute

String

Baggage chute details e.g CH-2

flightRecords[].departure.chuteSlots[]

Array

Chute Slots

flightRecords[].departure.chuteSlots[].area

String

Location details of the slot resource i.e check-in desks1-20, Gate 2C etc

flightRecords[].departure.chuteSlots[].endTime

String

End time for the slot activity e.g check-in desk closed

flightRecords[].departure.chuteSlots[].externalName

String

Name used to identify the slot

flightRecords[].departure.chuteSlots[].name

String

Name used to identify the slot internally

flightRecords[].departure.chuteSlots[].startTime

String

Start time for the slot activity e.g check-in desk opened

flightRecords[].departure.customProperties[]

Array

Custom Properties

flightRecords[].departure.customProperties[].key

String

Key value used to identify a custom property

flightRecords[].departure.customProperties[].value

String

The value of a custom property

flightRecords[].departure.diversion

Object

Flight Diversion Details.

flightRecords[].departure.diversion.original

Object

Flight Diversion original record

flightRecords[].departure.diversion.original.airport

Object

Airport

flightRecords[].departure.diversion.original.airport.city

String

The city in which the airport is located e.g New York

flightRecords[].departure.diversion.original.airport.cityText

String

The city in which the airport is located e.g New York

flightRecords[].departure.diversion.original.airport.iataCode

String

3-character airport IATA code e.g JFK

flightRecords[].departure.diversion.original.airport.icaoCode

String

4-character airport ICAO code e.g KJFK

flightRecords[].departure.diversion.original.airport.name

String

The name of the airport e.g John F Kennedy International Airport

flightRecords[].departure.diversion.original.flightNumber

String

Diversion flight original flight number

flightRecords[].departure.diversion.original.iataCode

String

Diversion flight original airline iata code

flightRecords[].departure.diversion.original.icaoCode

String

Diversion flight original airline icao code

flightRecords[].departure.diversion.original.name

String

Diversion flight original airline name

flightRecords[].departure.diversion.original.scheduled

String

Diversion flight original scheduled date of operation

flightRecords[].departure.diversion.recovery

Object

Flight Diversion recovery record

flightRecords[].departure.diversion.recovery.airport

Object

Airport

flightRecords[].departure.diversion.recovery.airport.city

String

The city in which the airport is located e.g New York

flightRecords[].departure.diversion.recovery.airport.cityText

String

The city in which the airport is located e.g New York

flightRecords[].departure.diversion.recovery.airport.iataCode

String

3-character airport IATA code e.g JFK

flightRecords[].departure.diversion.recovery.airport.icaoCode

String

4-character airport ICAO code e.g KJFK

flightRecords[].departure.diversion.recovery.airport.name

String

The name of the airport e.g John F Kennedy International Airport

flightRecords[].departure.diversion.recovery.flightNumber

String

Diversion flight recovery flight number

flightRecords[].departure.diversion.recovery.iataCode

String

Diversion flight recovery airline iata code

flightRecords[].departure.diversion.recovery.icaoCode

String

Diversion flight recovery airline icao code

flightRecords[].departure.diversion.recovery.name

String

Diversion flight recovery airline name

flightRecords[].departure.diversion.recovery.scheduled

String

Diversion flight recovery scheduled date of operation

flightRecords[].departure.estimated

String

The latest estimated local departure/arrival time for this flight e.g 2020-01-22T12:00:00+03:00

flightRecords[].departure.events

Object

Flight events.

flightRecords[].departure.events.AIBT

String

The actual local time at which the aircraft arrived at the gate

flightRecords[].departure.events.ALDT

String

The actual local time at which the aircraft landed on the runway

flightRecords[].departure.events.AOBT

String

The actual local time at which the aircraft left the gate

flightRecords[].departure.events.ATOT

String

The actual local time at which the aircraft left the runway

flightRecords[].departure.events.EIBT

String

The estimated local time at which the aircraft is expected at the gate

flightRecords[].departure.events.ELDT

String

The estimated local time at which the aircraft is expected to land on the runway

flightRecords[].departure.events.EOBT

String

The estimated local time at which the aircraft is expected to leave the gate

flightRecords[].departure.events.ETOT

String

The estimated local time at which the aircraft is expected to leave the runway

flightRecords[].departure.events.TOBT

String

The local time at which the aircraft is targeted to leave the gate

flightRecords[].departure.events.TTOT

String

The local time at which the aircraft is targeted to leave the runway

flightRecords[].departure.gate

String

The flights departure/arrival gate e.g C1

flightRecords[].departure.gateRemark

String

Departure gate remark

flightRecords[].departure.gateRemarkText

String

Gate remark text when applicable e.g Boarding at 21:00

flightRecords[].departure.gateSlots[]

Array

Gate Slots

flightRecords[].departure.gateSlots[].area

String

Location details of the slot resource i.e check-in desks1-20, Gate 2C etc

flightRecords[].departure.gateSlots[].endTime

String

End time for the slot activity e.g check-in desk closed

flightRecords[].departure.gateSlots[].externalName

String

Name used to identify the slot

flightRecords[].departure.gateSlots[].name

String

Name used to identify the slot internally

flightRecords[].departure.gateSlots[].startTime

String

Start time for the slot activity e.g check-in desk opened

flightRecords[].departure.route[]

Array

Route

flightRecords[].departure.route[].iataCode

String

3-character airport IATA code

flightRecords[].departure.route[].icaoCode

String

4-character airport ICAO code

flightRecords[].departure.route[].sequenceNumber

String

Value used to identify the routes position within an entire flight route e.g leg 0, leg 1, leg 2 etc

flightRecords[].departure.scheduled

String

The published scheduled local departure/arrival time for this flight e.g 2020-01-22T12:00:00+03:00

flightRecords[].departure.stand

String

Aircraft stand details e.g S12

flightRecords[].departure.standSlots[]

Array

Stand Slots

flightRecords[].departure.standSlots[].area

String

Location details of the slot resource i.e check-in desks1-20, Gate 2C etc

flightRecords[].departure.standSlots[].endTime

String

End time for the slot activity e.g check-in desk closed

flightRecords[].departure.standSlots[].externalName

String

Name used to identify the slot

flightRecords[].departure.standSlots[].name

String

Name used to identify the slot internally

flightRecords[].departure.standSlots[].startTime

String

Start time for the slot activity e.g check-in desk opened

flightRecords[].departure.status

String

The current status code for this flight e.g SC, DP

flightRecords[].departure.statusText

String

The current status text for this flight e.g Scheduled, Departed

flightRecords[].departure.terminal

String

The flights departure/arrival terminal e.g T1

flightRecords[].departure.updates[]

Array

Updates

flightRecords[].departure.updates[].current

String

Current field value

flightRecords[].departure.updates[].metadata.lastUpdateTime

String

UTC timestamp when update was applied (only visible when updates are grouped)

flightRecords[].departure.updates[].metadata.provider

String

Data source of this update (only visible when updates are grouped)

flightRecords[].departure.updates[].previous

String

Previous field value

flightRecords[].departure.updates[].received

String

UTC timestamp when update was received

flightRecords[].departure.updates[].updatedField

Object

Payload field which was updated

flightRecords[].departure.version

Number

FLIFO internal version number

flightRecords[].duration

String

Flight duration in minutes e.g 60

flightRecords[].flightIdentifier

Object

Flight Identifier

flightRecords[].flightIdentifier.aircraft

Object

Aircraft

flightRecords[].flightIdentifier.aircraft.callSign

String

Callsign for the aircraft type

flightRecords[].flightIdentifier.aircraft.iataCode

String

IATA code for the aircraft

flightRecords[].flightIdentifier.aircraft.icaoCode

String

ICAO code for the aircraft

flightRecords[].flightIdentifier.aircraft.model

String

Specific aircraft model details

flightRecords[].flightIdentifier.aircraft.registration

String

Aircraft regristration/tail number details e.g EIAA44W

flightRecords[].flightIdentifier.flightId

String

A value that uniquely identifies a flight within the system

flightRecords[].flightIdentifier.marketingCarriers[]

Array

Marketing Carriers

flightRecords[].flightIdentifier.marketingCarriers[].flightNumber

String

Flight number e.g 1234

flightRecords[].flightIdentifier.marketingCarriers[].iataCode

String

2-character airline IATA code e.g AA

flightRecords[].flightIdentifier.marketingCarriers[].icaoCode

String

3-character airline ICAO code e.g AAL

flightRecords[].flightIdentifier.marketingCarriers[].name

String

Name of airline e.g American Airlines

flightRecords[].flightIdentifier.operatingCarrier

Object

Operating Carrier

flightRecords[].flightIdentifier.operatingCarrier.flightNumber

String

Flight number e.g 1234

flightRecords[].flightIdentifier.operatingCarrier.iataCode

String

2-character airline IATA code e.g A

flightRecords[].flightIdentifier.operatingCarrier.icaoCode

String

3-character airline ICAO code e.g AAL

flightRecords[].flightIdentifier.operatingCarrier.name

String

Name of airline e.g American Airlines

flightRecords[].flightStats

Object

Flight Stats

flightRecords[].flightStats.baggage

Object

Baggage

flightRecords[].flightStats.baggage.cargo

String

Total number of cargo pieces

flightRecords[].flightStats.baggage.count

String

Total number of bags/pieces

flightRecords[].flightStats.baggage.load

String

Load breakdown

flightRecords[].flightStats.baggage.mail

String

Total number of mail pieces

flightRecords[].flightStats.baggage.totalWeight

String

Total weight of bags/pieces

flightRecords[].flightStats.passengers

Object

Passengers

flightRecords[].flightStats.passengers.actualBusiness

String

Actual number of business class passengers

flightRecords[].flightStats.passengers.actualEconomy

String

Actual number of economy class passengers

flightRecords[].flightStats.passengers.actualFirst

String

Actual number of 1st class passengers

flightRecords[].flightStats.passengers.actualTotal

String

Actual number of passengers

flightRecords[].flightStats.passengers.actualTransfer

String

Actual number of transfer passengers

flightRecords[].flightStats.passengers.actualTransit

String

Actual number of transit passengers

flightRecords[].flightStats.passengers.adult

String

Total number of adults

flightRecords[].flightStats.passengers.bookedBusiness

String

Total number of booked business class passengers

flightRecords[].flightStats.passengers.bookedEconomy

String

Total number of booked economy class passengers

flightRecords[].flightStats.passengers.bookedFirst

String

Total number of booked 1st class passengers

flightRecords[].flightStats.passengers.bookedTotal

String

Total number of booked passengers

flightRecords[].flightStats.passengers.child

String

Total number of children

flightRecords[].flightStats.passengers.infant

String

Total number of infants

flightRecords[].flightStats.passengers.reducedMobility

String

Total number of reduced mobility passengers e.g those requiring assistance boarding the aircraft etc.

flightRecords[].metadata.lastUpdateTime

String

UTC timestamp when update was applied

flightRecords[].metadata.provider

String

Data source of this update

flightRecords[].serviceType

String

Flight service type e.g J-Passenger, F-Cargo

groupMarketingCarriers

Object

Group Marketing Carriers

groupUpdates

Object

Group Updates

includeUpdates

Object

Include Updates

interval

Object

Interval

interval.from

Object

From

interval.from.serialVersionUID

Object

Serial Version UID

interval.to

Object

To

interval.to.serialVersionUID

Object

Serial Version UID

matchedRecords

Number

Matched Records

sessionId

Object

Session Id

sessionId.$assertionsDisabled

Object

$ assertions Disabled

sessionId.leastSigBits

Object

Least Sig Bits

sessionId.mostSigBits

Object

Most Sig Bits

sessionId.serialVersionUID

Object

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
/flightinfo/v2/flights/updates/airport/{airportCode}/airline/{airlineCode}
ParameterDescription

airportCode

3-character airport IATA code or 4-character airport ICAO code

airlineCode

2-character airline IATA code or 3-character airline ICAO code

Query parameters
ParameterDescription

from

Date interval start e.g 2020-01-01T12:00:00-0000. Default is current UTC date/time - 2 minutes

to

Date interval end e.g 2020-01-01T12:05:00-0000. Default is current UTC date/time - 1 minutes

includeUpdates

Show updated fields

groupMarketingCarriers

Group marketing and operating carrier flights into a single record. Default value is false

groupRecords

Group updates in a single record

verbose

Show additional information such as version

showCargo

Include cargo flights. Default value is false

arrivalDeparture

1-character direction indicator (A/D)

Request headers
NameOptionalDescription

Content-Type

false

Content type of this request. Required value is 'application/json'

Authorization

false

Authorization header that contains the access token.

Response fields
PathTypeDescription

flightRecords[]

Array

Flight Records

flightRecords[].arrival

Object

Arrival

flightRecords[].arrival.actual

String

The actual local departure/arrival time for this flight e.g 2020-01-22T12:00:00+03:00

flightRecords[].arrival.airport

Object

Airport

flightRecords[].arrival.airport.city

String

The city in which the airport is located e.g New York

flightRecords[].arrival.airport.cityText

String

The city in which the airport is located e.g New York

flightRecords[].arrival.airport.iataCode

String

3-character airport IATA code e.g JFK

flightRecords[].arrival.airport.icaoCode

String

4-character airport ICAO code e.g KJFK

flightRecords[].arrival.airport.name

String

The name of the airport e.g John F Kennedy International Airport

flightRecords[].arrival.carousel

String

Expected carousel(s) for baggage reclaim

flightRecords[].arrival.carouselSlots[]

Array

Carousel Slots

flightRecords[].arrival.carouselSlots[].area

String

Location details of the slot resource i.e check-in desks1-20, Gate 2C etc

flightRecords[].arrival.carouselSlots[].endTime

String

End time for the slot activity e.g check-in desk closed

flightRecords[].arrival.carouselSlots[].externalName

String

Name used to identify the slot

flightRecords[].arrival.carouselSlots[].name

String

Name used to identify the slot internally

flightRecords[].arrival.carouselSlots[].startTime

String

Start time for the slot activity e.g check-in desk opened

flightRecords[].arrival.checkIn

String

Check-in desk details e.g CK-1

flightRecords[].arrival.checkinSlots[]

Array

Checkin Slots

flightRecords[].arrival.checkinSlots[].area

String

Location details of the slot resource i.e check-in desks1-20, Gate 2C etc

flightRecords[].arrival.checkinSlots[].endTime

String

End time for the slot activity e.g check-in desk closed

flightRecords[].arrival.checkinSlots[].externalName

String

Name used to identify the slot

flightRecords[].arrival.checkinSlots[].name

String

Name used to identify the slot internally

flightRecords[].arrival.checkinSlots[].startTime

String

Start time for the slot activity e.g check-in desk opened

flightRecords[].arrival.chute

String

Baggage chute details e.g CH-2

flightRecords[].arrival.chuteSlots[]

Array

Chute Slots

flightRecords[].arrival.chuteSlots[].area

String

Location details of the slot resource i.e check-in desks1-20, Gate 2C etc

flightRecords[].arrival.chuteSlots[].endTime

String

End time for the slot activity e.g check-in desk closed

flightRecords[].arrival.chuteSlots[].externalName

String

Name used to identify the slot

flightRecords[].arrival.chuteSlots[].name

String

Name used to identify the slot internally

flightRecords[].arrival.chuteSlots[].startTime

String

Start time for the slot activity e.g check-in desk opened

flightRecords[].arrival.customProperties[]

Array

Custom Properties

flightRecords[].arrival.customProperties[].key

String

Key value used to identify a custom property

flightRecords[].arrival.customProperties[].value

String

The value of a custom property

flightRecords[].arrival.diversion

Object

Flight Diversion Details.

flightRecords[].arrival.diversion.original

Object

Flight Diversion original record

flightRecords[].arrival.diversion.original.airport

Object

Airport

flightRecords[].arrival.diversion.original.airport.city

String

The city in which the airport is located e.g New York

flightRecords[].arrival.diversion.original.airport.cityText

String

The city in which the airport is located e.g New York

flightRecords[].arrival.diversion.original.airport.iataCode

String

3-character airport IATA code e.g JFK

flightRecords[].arrival.diversion.original.airport.icaoCode

String

4-character airport ICAO code e.g KJFK

flightRecords[].arrival.diversion.original.airport.name

String

The name of the airport e.g John F Kennedy International Airport

flightRecords[].arrival.diversion.original.flightNumber

String

Diversion flight original flight number

flightRecords[].arrival.diversion.original.iataCode

String

Diversion flight original airline iata code

flightRecords[].arrival.diversion.original.icaoCode

String

Diversion flight original airline icao code

flightRecords[].arrival.diversion.original.name

String

Diversion flight original airline name

flightRecords[].arrival.diversion.original.scheduled

String

Diversion flight original scheduled date of operation

flightRecords[].arrival.diversion.recovery

Object

Flight Diversion recovery record

flightRecords[].arrival.diversion.recovery.airport

Object

Airport

flightRecords[].arrival.diversion.recovery.airport.city

String

The city in which the airport is located e.g New York

flightRecords[].arrival.diversion.recovery.airport.cityText

String

The city in which the airport is located e.g New York

flightRecords[].arrival.diversion.recovery.airport.iataCode

String

3-character airport IATA code e.g JFK

flightRecords[].arrival.diversion.recovery.airport.icaoCode

String

4-character airport ICAO code e.g KJFK

flightRecords[].arrival.diversion.recovery.airport.name

String

The name of the airport e.g John F Kennedy International Airport

flightRecords[].arrival.diversion.recovery.flightNumber

String

Diversion flight recovery flight number

flightRecords[].arrival.diversion.recovery.iataCode

String

Diversion flight recovery airline iata code

flightRecords[].arrival.diversion.recovery.icaoCode

String

Diversion flight recovery airline icao code

flightRecords[].arrival.diversion.recovery.name

String

Diversion flight recovery airline name

flightRecords[].arrival.diversion.recovery.scheduled

String

Diversion flight recovery scheduled date of operation

flightRecords[].arrival.estimated

String

The latest estimated local departure/arrival time for this flight e.g 2020-01-22T12:00:00+03:00

flightRecords[].arrival.events

Object

Flight events.

flightRecords[].arrival.events.AIBT

String

The actual local time at which the aircraft arrived at the gate

flightRecords[].arrival.events.ALDT

String

The actual local time at which the aircraft landed on the runway

flightRecords[].arrival.events.AOBT

String

The actual local time at which the aircraft left the gate

flightRecords[].arrival.events.ATOT

String

The actual local time at which the aircraft left the runway

flightRecords[].arrival.events.EIBT

String

The estimated local time at which the aircraft is expected at the gate

flightRecords[].arrival.events.ELDT

String

The estimated local time at which the aircraft is expected to land on the runway

flightRecords[].arrival.events.EOBT

String

The estimated local time at which the aircraft is expected to leave the gate

flightRecords[].arrival.events.ETOT

String

The estimated local time at which the aircraft is expected to leave the runway

flightRecords[].arrival.events.TOBT

String

The local time at which the aircraft is targeted to leave the gate

flightRecords[].arrival.events.TTOT

String

The local time at which the aircraft is targeted to leave the runway

flightRecords[].arrival.gate

String

The flights departure/arrival gate e.g C1

flightRecords[].arrival.gateRemark

String

Arrival gate remark

flightRecords[].arrival.gateRemarkText

String

Gate remark text when applicable e.g Boarding at 21:00

flightRecords[].arrival.gateSlots[]

Array

Gate Slots

flightRecords[].arrival.gateSlots[].area

String

Location details of the slot resource i.e check-in desks1-20, Gate 2C etc

flightRecords[].arrival.gateSlots[].endTime

String

End time for the slot activity e.g check-in desk closed

flightRecords[].arrival.gateSlots[].externalName

String

Name used to identify the slot

flightRecords[].arrival.gateSlots[].name

String

Name used to identify the slot internally

flightRecords[].arrival.gateSlots[].startTime

String

Start time for the slot activity e.g check-in desk opened

flightRecords[].arrival.route[]

Array

Route

flightRecords[].arrival.route[].iataCode

String

3-character airport IATA code

flightRecords[].arrival.route[].icaoCode

String

4-character airport ICAO code

flightRecords[].arrival.route[].sequenceNumber

String

Value used to identify the routes position within an entire flight route e.g leg 0, leg 1, leg 2 etc

flightRecords[].arrival.scheduled

String

The published scheduled local departure/arrival time for this flight e.g 2020-01-22T12:00:00+03:00

flightRecords[].arrival.stand

String

Aircraft stand details e.g S12

flightRecords[].arrival.standSlots[]

Array

Stand Slots

flightRecords[].arrival.standSlots[].area

String

Location details of the slot resource i.e check-in desks1-20, Gate 2C etc

flightRecords[].arrival.standSlots[].endTime

String

End time for the slot activity e.g check-in desk closed

flightRecords[].arrival.standSlots[].externalName

String

Name used to identify the slot

flightRecords[].arrival.standSlots[].name

String

Name used to identify the slot internally

flightRecords[].arrival.standSlots[].startTime

String

Start time for the slot activity e.g check-in desk opened

flightRecords[].arrival.status

String

The current status code for this flight e.g SC, DP

flightRecords[].arrival.statusText

String

The current status text for this flight e.g Scheduled, Departed

flightRecords[].arrival.terminal

String

The flights departure/arrival terminal e.g T1

flightRecords[].arrival.updates[]

Array

Updates

flightRecords[].arrival.updates[].current

String

Current field value

flightRecords[].arrival.updates[].metadata.lastUpdateTime

String

UTC timestamp when update was applied (only visible when updates are grouped)

flightRecords[].arrival.updates[].metadata.provider

String

Data source of this update (only visible when updates are grouped)

flightRecords[].arrival.updates[].previous

String

Previous field value

flightRecords[].arrival.updates[].received

String

UTC timestamp when update was received

flightRecords[].arrival.updates[].updatedField

Object

Payload field which was updated

flightRecords[].arrival.version

Number

FLIFO internal version number

flightRecords[].departure

Object

Departure

flightRecords[].departure.actual

String

The actual local departure/arrival time for this flight e.g 2020-01-22T12:00:00+03:00

flightRecords[].departure.airport

Object

Airport

flightRecords[].departure.airport.city

String

The city in which the airport is located e.g New York

flightRecords[].departure.airport.cityText

String

The city in which the airport is located e.g New York

flightRecords[].departure.airport.iataCode

String

3-character airport IATA code e.g JFK

flightRecords[].departure.airport.icaoCode

String

4-character airport ICAO code e.g KJFK

flightRecords[].departure.airport.name

String

The name of the airport e.g John F Kennedy International Airport

flightRecords[].departure.carousel

String

Expected carousel(s) for baggage reclaim

flightRecords[].departure.carouselSlots[]

Array

Carousel Slots

flightRecords[].departure.carouselSlots[].area

String

Location details of the slot resource i.e check-in desks1-20, Gate 2C etc

flightRecords[].departure.carouselSlots[].endTime

String

End time for the slot activity e.g check-in desk closed

flightRecords[].departure.carouselSlots[].externalName

String

Name used to identify the slot

flightRecords[].departure.carouselSlots[].name

String

Name used to identify the slot internally

flightRecords[].departure.carouselSlots[].startTime

String

Start time for the slot activity e.g check-in desk opened

flightRecords[].departure.checkIn

String

Check-in desk details e.g CK-1

flightRecords[].departure.checkinSlots[]

Array

Checkin Slots

flightRecords[].departure.checkinSlots[].area

String

Location details of the slot resource i.e check-in desks1-20, Gate 2C etc

flightRecords[].departure.checkinSlots[].endTime

String

End time for the slot activity e.g check-in desk closed

flightRecords[].departure.checkinSlots[].externalName

String

Name used to identify the slot

flightRecords[].departure.checkinSlots[].name

String

Name used to identify the slot internally

flightRecords[].departure.checkinSlots[].startTime

String

Start time for the slot activity e.g check-in desk opened

flightRecords[].departure.chute

String

Baggage chute details e.g CH-2

flightRecords[].departure.chuteSlots[]

Array

Chute Slots

flightRecords[].departure.chuteSlots[].area

String

Location details of the slot resource i.e check-in desks1-20, Gate 2C etc

flightRecords[].departure.chuteSlots[].endTime

String

End time for the slot activity e.g check-in desk closed

flightRecords[].departure.chuteSlots[].externalName

String

Name used to identify the slot

flightRecords[].departure.chuteSlots[].name

String

Name used to identify the slot internally

flightRecords[].departure.chuteSlots[].startTime

String

Start time for the slot activity e.g check-in desk opened

flightRecords[].departure.customProperties[]

Array

Custom Properties

flightRecords[].departure.customProperties[].key

String

Key value used to identify a custom property

flightRecords[].departure.customProperties[].value

String

The value of a custom property

flightRecords[].departure.diversion

Object

Flight Diversion Details.

flightRecords[].departure.diversion.original

Object

Flight Diversion original record

flightRecords[].departure.diversion.original.airport

Object

Airport

flightRecords[].departure.diversion.original.airport.city

String

The city in which the airport is located e.g New York

flightRecords[].departure.diversion.original.airport.cityText

String

The city in which the airport is located e.g New York

flightRecords[].departure.diversion.original.airport.iataCode

String

3-character airport IATA code e.g JFK

flightRecords[].departure.diversion.original.airport.icaoCode

String

4-character airport ICAO code e.g KJFK

flightRecords[].departure.diversion.original.airport.name

String

The name of the airport e.g John F Kennedy International Airport

flightRecords[].departure.diversion.original.flightNumber

String

Diversion flight original flight number

flightRecords[].departure.diversion.original.iataCode

String

Diversion flight original airline iata code

flightRecords[].departure.diversion.original.icaoCode

String

Diversion flight original airline icao code

flightRecords[].departure.diversion.original.name

String

Diversion flight original airline name

flightRecords[].departure.diversion.original.scheduled

String

Diversion flight original scheduled date of operation

flightRecords[].departure.diversion.recovery

Object

Flight Diversion recovery record

flightRecords[].departure.diversion.recovery.airport

Object

Airport

flightRecords[].departure.diversion.recovery.airport.city

String

The city in which the airport is located e.g New York

flightRecords[].departure.diversion.recovery.airport.cityText

String

The city in which the airport is located e.g New York

flightRecords[].departure.diversion.recovery.airport.iataCode

String

3-character airport IATA code e.g JFK

flightRecords[].departure.diversion.recovery.airport.icaoCode

String

4-character airport ICAO code e.g KJFK

flightRecords[].departure.diversion.recovery.airport.name

String

The name of the airport e.g John F Kennedy International Airport

flightRecords[].departure.diversion.recovery.flightNumber

String

Diversion flight recovery flight number

flightRecords[].departure.diversion.recovery.iataCode

String

Diversion flight recovery airline iata code

flightRecords[].departure.diversion.recovery.icaoCode

String

Diversion flight recovery airline icao code

flightRecords[].departure.diversion.recovery.name

String

Diversion flight recovery airline name

flightRecords[].departure.diversion.recovery.scheduled

String

Diversion flight recovery scheduled date of operation

flightRecords[].departure.estimated

String

The latest estimated local departure/arrival time for this flight e.g 2020-01-22T12:00:00+03:00

flightRecords[].departure.events

Object

Flight events.

flightRecords[].departure.events.AIBT

String

The actual local time at which the aircraft arrived at the gate

flightRecords[].departure.events.ALDT

String

The actual local time at which the aircraft landed on the runway

flightRecords[].departure.events.AOBT

String

The actual local time at which the aircraft left the gate

flightRecords[].departure.events.ATOT

String

The actual local time at which the aircraft left the runway

flightRecords[].departure.events.EIBT

String

The estimated local time at which the aircraft is expected at the gate

flightRecords[].departure.events.ELDT

String

The estimated local time at which the aircraft is expected to land on the runway

flightRecords[].departure.events.EOBT

String

The estimated local time at which the aircraft is expected to leave the gate

flightRecords[].departure.events.ETOT

String

The estimated local time at which the aircraft is expected to leave the runway

flightRecords[].departure.events.TOBT

String

The local time at which the aircraft is targeted to leave the gate

flightRecords[].departure.events.TTOT

String

The local time at which the aircraft is targeted to leave the runway

flightRecords[].departure.gate

String

The flights departure/arrival gate e.g C1

flightRecords[].departure.gateRemark

String

Departure gate remark

flightRecords[].departure.gateRemarkText

String

Gate remark text when applicable e.g Boarding at 21:00

flightRecords[].departure.gateSlots[]

Array

Gate Slots

flightRecords[].departure.gateSlots[].area

String

Location details of the slot resource i.e check-in desks1-20, Gate 2C etc

flightRecords[].departure.gateSlots[].endTime

String

End time for the slot activity e.g check-in desk closed

flightRecords[].departure.gateSlots[].externalName

String

Name used to identify the slot

flightRecords[].departure.gateSlots[].name

String

Name used to identify the slot internally

flightRecords[].departure.gateSlots[].startTime

String

Start time for the slot activity e.g check-in desk opened

flightRecords[].departure.route[]

Array

Route

flightRecords[].departure.route[].iataCode

String

3-character airport IATA code

flightRecords[].departure.route[].icaoCode

String

4-character airport ICAO code

flightRecords[].departure.route[].sequenceNumber

String

Value used to identify the routes position within an entire flight route e.g leg 0, leg 1, leg 2 etc

flightRecords[].departure.scheduled

String

The published scheduled local departure/arrival time for this flight e.g 2020-01-22T12:00:00+03:00

flightRecords[].departure.stand

String

Aircraft stand details e.g S12

flightRecords[].departure.standSlots[]

Array

Stand Slots

flightRecords[].departure.standSlots[].area

String

Location details of the slot resource i.e check-in desks1-20, Gate 2C etc

flightRecords[].departure.standSlots[].endTime

String

End time for the slot activity e.g check-in desk closed

flightRecords[].departure.standSlots[].externalName

String

Name used to identify the slot

flightRecords[].departure.standSlots[].name

String

Name used to identify the slot internally

flightRecords[].departure.standSlots[].startTime

String

Start time for the slot activity e.g check-in desk opened

flightRecords[].departure.status

String

The current status code for this flight e.g SC, DP

flightRecords[].departure.statusText

String

The current status text for this flight e.g Scheduled, Departed

flightRecords[].departure.terminal

String

The flights departure/arrival terminal e.g T1

flightRecords[].departure.updates[]

Array

Updates

flightRecords[].departure.updates[].current

String

Current field value

flightRecords[].departure.updates[].metadata.lastUpdateTime

String

UTC timestamp when update was applied (only visible when updates are grouped)

flightRecords[].departure.updates[].metadata.provider

String

Data source of this update (only visible when updates are grouped)

flightRecords[].departure.updates[].previous

String

Previous field value

flightRecords[].departure.updates[].received

String

UTC timestamp when update was received

flightRecords[].departure.updates[].updatedField

Object

Payload field which was updated

flightRecords[].departure.version

Number

FLIFO internal version number

flightRecords[].duration

String

Flight duration in minutes e.g 60

flightRecords[].flightIdentifier

Object

Flight Identifier

flightRecords[].flightIdentifier.aircraft

Object

Aircraft

flightRecords[].flightIdentifier.aircraft.callSign

String

Callsign for the aircraft type

flightRecords[].flightIdentifier.aircraft.iataCode

String

IATA code for the aircraft

flightRecords[].flightIdentifier.aircraft.icaoCode

String

ICAO code for the aircraft

flightRecords[].flightIdentifier.aircraft.model

String

Specific aircraft model details

flightRecords[].flightIdentifier.aircraft.registration

String

Aircraft regristration/tail number details e.g EIAA44W

flightRecords[].flightIdentifier.flightId

String

A value that uniquely identifies a flight within the system

flightRecords[].flightIdentifier.marketingCarriers[]

Array

Marketing Carriers

flightRecords[].flightIdentifier.marketingCarriers[].flightNumber

String

Flight number e.g 1234

flightRecords[].flightIdentifier.marketingCarriers[].iataCode

String

2-character airline IATA code e.g AA

flightRecords[].flightIdentifier.marketingCarriers[].icaoCode

String

3-character airline ICAO code e.g AAL

flightRecords[].flightIdentifier.marketingCarriers[].name

String

Name of airline e.g American Airlines

flightRecords[].flightIdentifier.operatingCarrier

Object

Operating Carrier

flightRecords[].flightIdentifier.operatingCarrier.flightNumber

String

Flight number e.g 1234

flightRecords[].flightIdentifier.operatingCarrier.iataCode

String

2-character airline IATA code e.g A

flightRecords[].flightIdentifier.operatingCarrier.icaoCode

String

3-character airline ICAO code e.g AAL

flightRecords[].flightIdentifier.operatingCarrier.name

String

Name of airline e.g American Airlines

flightRecords[].flightStats

Object

Flight Stats

flightRecords[].flightStats.baggage

Object

Baggage

flightRecords[].flightStats.baggage.cargo

String

Total number of cargo pieces

flightRecords[].flightStats.baggage.count

String

Total number of bags/pieces

flightRecords[].flightStats.baggage.load

String

Load breakdown

flightRecords[].flightStats.baggage.mail

String

Total number of mail pieces

flightRecords[].flightStats.baggage.totalWeight

String

Total weight of bags/pieces

flightRecords[].flightStats.passengers

Object

Passengers

flightRecords[].flightStats.passengers.actualBusiness

String

Actual number of business class passengers

flightRecords[].flightStats.passengers.actualEconomy

String

Actual number of economy class passengers

flightRecords[].flightStats.passengers.actualFirst

String

Actual number of 1st class passengers

flightRecords[].flightStats.passengers.actualTotal

String

Actual number of passengers

flightRecords[].flightStats.passengers.actualTransfer

String

Actual number of transfer passengers

flightRecords[].flightStats.passengers.actualTransit

String

Actual number of transit passengers

flightRecords[].flightStats.passengers.adult

String

Total number of adults

flightRecords[].flightStats.passengers.bookedBusiness

String

Total number of booked business class passengers

flightRecords[].flightStats.passengers.bookedEconomy

String

Total number of booked economy class passengers

flightRecords[].flightStats.passengers.bookedFirst

String

Total number of booked 1st class passengers

flightRecords[].flightStats.passengers.bookedTotal

String

Total number of booked passengers

flightRecords[].flightStats.passengers.child

String

Total number of children

flightRecords[].flightStats.passengers.infant

String

Total number of infants

flightRecords[].flightStats.passengers.reducedMobility

String

Total number of reduced mobility passengers e.g those requiring assistance boarding the aircraft etc.

flightRecords[].metadata.lastUpdateTime

String

UTC timestamp when update was applied

flightRecords[].metadata.provider

String

Data source of this update

flightRecords[].serviceType

String

Flight service type e.g J-Passenger, F-Cargo

groupMarketingCarriers

Object

Group Marketing Carriers

groupUpdates

Object

Group Updates

includeUpdates

Object

Include Updates

interval

Object

Interval

interval.from

Object

From

interval.from.serialVersionUID

Object

Serial Version UID

interval.to

Object

To

interval.to.serialVersionUID

Object

Serial Version UID

matchedRecords

Number

Matched Records

sessionId

Object

Session Id

sessionId.$assertionsDisabled

Object

$ assertions Disabled

sessionId.leastSigBits

Object

Least Sig Bits

sessionId.mostSigBits

Object

Most Sig Bits

sessionId.serialVersionUID

Object

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
/flightinfo/v2/flights/updates/airport/{airportCode}
ParameterDescription

airportCode

3-character airport IATA code or 4-character airport ICAO code

Query parameters
ParameterDescription

from

Date interval start e.g 2020-01-01T12:00:00-0000. Default is current UTC date/time - 2 minutes

to

Date interval end e.g 2020-01-01T12:05:00-0000. Default is current UTC date/time - 1 minutes

includeUpdates

Show updated fields

groupMarketingCarriers

Group marketing and operating carrier flights into a single record. Default value is false

groupRecords

Group updates in a single record

verbose

Show additional information such as version

showCargo

Include cargo flights. Default value is false

arrivalDeparture

1-character direction indicator (A/D)

Request headers
NameOptionalDescription

Content-Type

false

Content type of this request. Required value is 'application/json'

Authorization

false

Authorization header that contains the access token.

Response fields
PathTypeDescription

flightRecords[]

Array

Flight Records

flightRecords[].arrival

Object

Arrival

flightRecords[].arrival.actual

String

The actual local departure/arrival time for this flight e.g 2020-01-22T12:00:00+03:00

flightRecords[].arrival.airport

Object

Airport

flightRecords[].arrival.airport.city

String

The city in which the airport is located e.g New York

flightRecords[].arrival.airport.cityText

String

The city in which the airport is located e.g New York

flightRecords[].arrival.airport.iataCode

String

3-character airport IATA code e.g JFK

flightRecords[].arrival.airport.icaoCode

String

4-character airport ICAO code e.g KJFK

flightRecords[].arrival.airport.name

String

The name of the airport e.g John F Kennedy International Airport

flightRecords[].arrival.carousel

String

Expected carousel(s) for baggage reclaim

flightRecords[].arrival.carouselSlots[]

Array

Carousel Slots

flightRecords[].arrival.carouselSlots[].area

String

Location details of the slot resource i.e check-in desks1-20, Gate 2C etc

flightRecords[].arrival.carouselSlots[].endTime

String

End time for the slot activity e.g check-in desk closed

flightRecords[].arrival.carouselSlots[].externalName

String

Name used to identify the slot

flightRecords[].arrival.carouselSlots[].name

String

Name used to identify the slot internally

flightRecords[].arrival.carouselSlots[].startTime

String

Start time for the slot activity e.g check-in desk opened

flightRecords[].arrival.checkIn

String

Check-in desk details e.g CK-1

flightRecords[].arrival.checkinSlots[]

Array

Checkin Slots

flightRecords[].arrival.checkinSlots[].area

String

Location details of the slot resource i.e check-in desks1-20, Gate 2C etc

flightRecords[].arrival.checkinSlots[].endTime

String

End time for the slot activity e.g check-in desk closed

flightRecords[].arrival.checkinSlots[].externalName

String

Name used to identify the slot

flightRecords[].arrival.checkinSlots[].name

String

Name used to identify the slot internally

flightRecords[].arrival.checkinSlots[].startTime

String

Start time for the slot activity e.g check-in desk opened

flightRecords[].arrival.chute

String

Baggage chute details e.g CH-2

flightRecords[].arrival.chuteSlots[]

Array

Chute Slots

flightRecords[].arrival.chuteSlots[].area

String

Location details of the slot resource i.e check-in desks1-20, Gate 2C etc

flightRecords[].arrival.chuteSlots[].endTime

String

End time for the slot activity e.g check-in desk closed

flightRecords[].arrival.chuteSlots[].externalName

String

Name used to identify the slot

flightRecords[].arrival.chuteSlots[].name

String

Name used to identify the slot internally

flightRecords[].arrival.chuteSlots[].startTime

String

Start time for the slot activity e.g check-in desk opened

flightRecords[].arrival.customProperties[]

Array

Custom Properties

flightRecords[].arrival.customProperties[].key

String

Key value used to identify a custom property

flightRecords[].arrival.customProperties[].value

String

The value of a custom property

flightRecords[].arrival.diversion

Object

Flight Diversion Details.

flightRecords[].arrival.diversion.original

Object

Flight Diversion original record

flightRecords[].arrival.diversion.original.airport

Object

Airport

flightRecords[].arrival.diversion.original.airport.city

String

The city in which the airport is located e.g New York

flightRecords[].arrival.diversion.original.airport.cityText

String

The city in which the airport is located e.g New York

flightRecords[].arrival.diversion.original.airport.iataCode

String

3-character airport IATA code e.g JFK

flightRecords[].arrival.diversion.original.airport.icaoCode

String

4-character airport ICAO code e.g KJFK

flightRecords[].arrival.diversion.original.airport.name

String

The name of the airport e.g John F Kennedy International Airport

flightRecords[].arrival.diversion.original.flightNumber

String

Diversion flight original flight number

flightRecords[].arrival.diversion.original.iataCode

String

Diversion flight original airline iata code

flightRecords[].arrival.diversion.original.icaoCode

String

Diversion flight original airline icao code

flightRecords[].arrival.diversion.original.name

String

Diversion flight original airline name

flightRecords[].arrival.diversion.original.scheduled

String

Diversion flight original scheduled date of operation

flightRecords[].arrival.diversion.recovery

Object

Flight Diversion recovery record

flightRecords[].arrival.diversion.recovery.airport

Object

Airport

flightRecords[].arrival.diversion.recovery.airport.city

String

The city in which the airport is located e.g New York

flightRecords[].arrival.diversion.recovery.airport.cityText

String

The city in which the airport is located e.g New York

flightRecords[].arrival.diversion.recovery.airport.iataCode

String

3-character airport IATA code e.g JFK

flightRecords[].arrival.diversion.recovery.airport.icaoCode

String

4-character airport ICAO code e.g KJFK

flightRecords[].arrival.diversion.recovery.airport.name

String

The name of the airport e.g John F Kennedy International Airport

flightRecords[].arrival.diversion.recovery.flightNumber

String

Diversion flight recovery flight number

flightRecords[].arrival.diversion.recovery.iataCode

String

Diversion flight recovery airline iata code

flightRecords[].arrival.diversion.recovery.icaoCode

String

Diversion flight recovery airline icao code

flightRecords[].arrival.diversion.recovery.name

String

Diversion flight recovery airline name

flightRecords[].arrival.diversion.recovery.scheduled

String

Diversion flight recovery scheduled date of operation

flightRecords[].arrival.estimated

String

The latest estimated local departure/arrival time for this flight e.g 2020-01-22T12:00:00+03:00

flightRecords[].arrival.events

Object

Flight events.

flightRecords[].arrival.events.AIBT

String

The actual local time at which the aircraft arrived at the gate

flightRecords[].arrival.events.ALDT

String

The actual local time at which the aircraft landed on the runway

flightRecords[].arrival.events.AOBT

String

The actual local time at which the aircraft left the gate

flightRecords[].arrival.events.ATOT

String

The actual local time at which the aircraft left the runway

flightRecords[].arrival.events.EIBT

String

The estimated local time at which the aircraft is expected at the gate

flightRecords[].arrival.events.ELDT

String

The estimated local time at which the aircraft is expected to land on the runway

flightRecords[].arrival.events.EOBT

String

The estimated local time at which the aircraft is expected to leave the gate

flightRecords[].arrival.events.ETOT

String

The estimated local time at which the aircraft is expected to leave the runway

flightRecords[].arrival.events.TOBT

String

The local time at which the aircraft is targeted to leave the gate

flightRecords[].arrival.events.TTOT

String

The local time at which the aircraft is targeted to leave the runway

flightRecords[].arrival.gate

String

The flights departure/arrival gate e.g C1

flightRecords[].arrival.gateRemark

String

Arrival gate remark

flightRecords[].arrival.gateRemarkText

String

Gate remark text when applicable e.g Boarding at 21:00

flightRecords[].arrival.gateSlots[]

Array

Gate Slots

flightRecords[].arrival.gateSlots[].area

String

Location details of the slot resource i.e check-in desks1-20, Gate 2C etc

flightRecords[].arrival.gateSlots[].endTime

String

End time for the slot activity e.g check-in desk closed

flightRecords[].arrival.gateSlots[].externalName

String

Name used to identify the slot

flightRecords[].arrival.gateSlots[].name

String

Name used to identify the slot internally

flightRecords[].arrival.gateSlots[].startTime

String

Start time for the slot activity e.g check-in desk opened

flightRecords[].arrival.route[]

Array

Route

flightRecords[].arrival.route[].iataCode

String

3-character airport IATA code

flightRecords[].arrival.route[].icaoCode

String

4-character airport ICAO code

flightRecords[].arrival.route[].sequenceNumber

String

Value used to identify the routes position within an entire flight route e.g leg 0, leg 1, leg 2 etc

flightRecords[].arrival.scheduled

String

The published scheduled local departure/arrival time for this flight e.g 2020-01-22T12:00:00+03:00

flightRecords[].arrival.stand

String

Aircraft stand details e.g S12

flightRecords[].arrival.standSlots[]

Array

Stand Slots

flightRecords[].arrival.standSlots[].area

String

Location details of the slot resource i.e check-in desks1-20, Gate 2C etc

flightRecords[].arrival.standSlots[].endTime

String

End time for the slot activity e.g check-in desk closed

flightRecords[].arrival.standSlots[].externalName

String

Name used to identify the slot

flightRecords[].arrival.standSlots[].name

String

Name used to identify the slot internally

flightRecords[].arrival.standSlots[].startTime

String

Start time for the slot activity e.g check-in desk opened

flightRecords[].arrival.status

String

The current status code for this flight e.g SC, DP

flightRecords[].arrival.statusText

String

The current status text for this flight e.g Scheduled, Departed

flightRecords[].arrival.terminal

String

The flights departure/arrival terminal e.g T1

flightRecords[].arrival.updates[]

Array

Updates

flightRecords[].arrival.updates[].current

String

Current field value

flightRecords[].arrival.updates[].metadata.lastUpdateTime

String

UTC timestamp when update was applied (only visible when updates are grouped)

flightRecords[].arrival.updates[].metadata.provider

String

Data source of this update (only visible when updates are grouped)

flightRecords[].arrival.updates[].previous

String

Previous field value

flightRecords[].arrival.updates[].received

String

UTC timestamp when update was received

flightRecords[].arrival.updates[].updatedField

Object

Payload field which was updated

flightRecords[].arrival.version

Number

FLIFO internal version number

flightRecords[].departure

Object

Departure

flightRecords[].departure.actual

String

The actual local departure/arrival time for this flight e.g 2020-01-22T12:00:00+03:00

flightRecords[].departure.airport

Object

Airport

flightRecords[].departure.airport.city

String

The city in which the airport is located e.g New York

flightRecords[].departure.airport.cityText

String

The city in which the airport is located e.g New York

flightRecords[].departure.airport.iataCode

String

3-character airport IATA code e.g JFK

flightRecords[].departure.airport.icaoCode

String

4-character airport ICAO code e.g KJFK

flightRecords[].departure.airport.name

String

The name of the airport e.g John F Kennedy International Airport

flightRecords[].departure.carousel

String

Expected carousel(s) for baggage reclaim

flightRecords[].departure.carouselSlots[]

Array

Carousel Slots

flightRecords[].departure.carouselSlots[].area

String

Location details of the slot resource i.e check-in desks1-20, Gate 2C etc

flightRecords[].departure.carouselSlots[].endTime

String

End time for the slot activity e.g check-in desk closed

flightRecords[].departure.carouselSlots[].externalName

String

Name used to identify the slot

flightRecords[].departure.carouselSlots[].name

String

Name used to identify the slot internally

flightRecords[].departure.carouselSlots[].startTime

String

Start time for the slot activity e.g check-in desk opened

flightRecords[].departure.checkIn

String

Check-in desk details e.g CK-1

flightRecords[].departure.checkinSlots[]

Array

Checkin Slots

flightRecords[].departure.checkinSlots[].area

String

Location details of the slot resource i.e check-in desks1-20, Gate 2C etc

flightRecords[].departure.checkinSlots[].endTime

String

End time for the slot activity e.g check-in desk closed

flightRecords[].departure.checkinSlots[].externalName

String

Name used to identify the slot

flightRecords[].departure.checkinSlots[].name

String

Name used to identify the slot internally

flightRecords[].departure.checkinSlots[].startTime

String

Start time for the slot activity e.g check-in desk opened

flightRecords[].departure.chute

String

Baggage chute details e.g CH-2

flightRecords[].departure.chuteSlots[]

Array

Chute Slots

flightRecords[].departure.chuteSlots[].area

String

Location details of the slot resource i.e check-in desks1-20, Gate 2C etc

flightRecords[].departure.chuteSlots[].endTime

String

End time for the slot activity e.g check-in desk closed

flightRecords[].departure.chuteSlots[].externalName

String

Name used to identify the slot

flightRecords[].departure.chuteSlots[].name

String

Name used to identify the slot internally

flightRecords[].departure.chuteSlots[].startTime

String

Start time for the slot activity e.g check-in desk opened

flightRecords[].departure.customProperties[]

Array

Custom Properties

flightRecords[].departure.customProperties[].key

String

Key value used to identify a custom property

flightRecords[].departure.customProperties[].value

String

The value of a custom property

flightRecords[].departure.diversion

Object

Flight Diversion Details.

flightRecords[].departure.diversion.original

Object

Flight Diversion original record

flightRecords[].departure.diversion.original.airport

Object

Airport

flightRecords[].departure.diversion.original.airport.city

String

The city in which the airport is located e.g New York

flightRecords[].departure.diversion.original.airport.cityText

String

The city in which the airport is located e.g New York

flightRecords[].departure.diversion.original.airport.iataCode

String

3-character airport IATA code e.g JFK

flightRecords[].departure.diversion.original.airport.icaoCode

String

4-character airport ICAO code e.g KJFK

flightRecords[].departure.diversion.original.airport.name

String

The name of the airport e.g John F Kennedy International Airport

flightRecords[].departure.diversion.original.flightNumber

String

Diversion flight original flight number

flightRecords[].departure.diversion.original.iataCode

String

Diversion flight original airline iata code

flightRecords[].departure.diversion.original.icaoCode

String

Diversion flight original airline icao code

flightRecords[].departure.diversion.original.name

String

Diversion flight original airline name

flightRecords[].departure.diversion.original.scheduled

String

Diversion flight original scheduled date of operation

flightRecords[].departure.diversion.recovery

Object

Flight Diversion recovery record

flightRecords[].departure.diversion.recovery.airport

Object

Airport

flightRecords[].departure.diversion.recovery.airport.city

String

The city in which the airport is located e.g New York

flightRecords[].departure.diversion.recovery.airport.cityText

String

The city in which the airport is located e.g New York

flightRecords[].departure.diversion.recovery.airport.iataCode

String

3-character airport IATA code e.g JFK

flightRecords[].departure.diversion.recovery.airport.icaoCode

String

4-character airport ICAO code e.g KJFK

flightRecords[].departure.diversion.recovery.airport.name

String

The name of the airport e.g John F Kennedy International Airport

flightRecords[].departure.diversion.recovery.flightNumber

String

Diversion flight recovery flight number

flightRecords[].departure.diversion.recovery.iataCode

String

Diversion flight recovery airline iata code

flightRecords[].departure.diversion.recovery.icaoCode

String

Diversion flight recovery airline icao code

flightRecords[].departure.diversion.recovery.name

String

Diversion flight recovery airline name

flightRecords[].departure.diversion.recovery.scheduled

String

Diversion flight recovery scheduled date of operation

flightRecords[].departure.estimated

String

The latest estimated local departure/arrival time for this flight e.g 2020-01-22T12:00:00+03:00

flightRecords[].departure.events

Object

Flight events.

flightRecords[].departure.events.AIBT

String

The actual local time at which the aircraft arrived at the gate

flightRecords[].departure.events.ALDT

String

The actual local time at which the aircraft landed on the runway

flightRecords[].departure.events.AOBT

String

The actual local time at which the aircraft left the gate

flightRecords[].departure.events.ATOT

String

The actual local time at which the aircraft left the runway

flightRecords[].departure.events.EIBT

String

The estimated local time at which the aircraft is expected at the gate

flightRecords[].departure.events.ELDT

String

The estimated local time at which the aircraft is expected to land on the runway

flightRecords[].departure.events.EOBT

String

The estimated local time at which the aircraft is expected to leave the gate

flightRecords[].departure.events.ETOT

String

The estimated local time at which the aircraft is expected to leave the runway

flightRecords[].departure.events.TOBT

String

The local time at which the aircraft is targeted to leave the gate

flightRecords[].departure.events.TTOT

String

The local time at which the aircraft is targeted to leave the runway

flightRecords[].departure.gate

String

The flights departure/arrival gate e.g C1

flightRecords[].departure.gateRemark

String

Departure gate remark

flightRecords[].departure.gateRemarkText

String

Gate remark text when applicable e.g Boarding at 21:00

flightRecords[].departure.gateSlots[]

Array

Gate Slots

flightRecords[].departure.gateSlots[].area

String

Location details of the slot resource i.e check-in desks1-20, Gate 2C etc

flightRecords[].departure.gateSlots[].endTime

String

End time for the slot activity e.g check-in desk closed

flightRecords[].departure.gateSlots[].externalName

String

Name used to identify the slot

flightRecords[].departure.gateSlots[].name

String

Name used to identify the slot internally

flightRecords[].departure.gateSlots[].startTime

String

Start time for the slot activity e.g check-in desk opened

flightRecords[].departure.route[]

Array

Route

flightRecords[].departure.route[].iataCode

String

3-character airport IATA code

flightRecords[].departure.route[].icaoCode

String

4-character airport ICAO code

flightRecords[].departure.route[].sequenceNumber

String

Value used to identify the routes position within an entire flight route e.g leg 0, leg 1, leg 2 etc

flightRecords[].departure.scheduled

String

The published scheduled local departure/arrival time for this flight e.g 2020-01-22T12:00:00+03:00

flightRecords[].departure.stand

String

Aircraft stand details e.g S12

flightRecords[].departure.standSlots[]

Array

Stand Slots

flightRecords[].departure.standSlots[].area

String

Location details of the slot resource i.e check-in desks1-20, Gate 2C etc

flightRecords[].departure.standSlots[].endTime

String

End time for the slot activity e.g check-in desk closed

flightRecords[].departure.standSlots[].externalName

String

Name used to identify the slot

flightRecords[].departure.standSlots[].name

String

Name used to identify the slot internally

flightRecords[].departure.standSlots[].startTime

String

Start time for the slot activity e.g check-in desk opened

flightRecords[].departure.status

String

The current status code for this flight e.g SC, DP

flightRecords[].departure.statusText

String

The current status text for this flight e.g Scheduled, Departed

flightRecords[].departure.terminal

String

The flights departure/arrival terminal e.g T1

flightRecords[].departure.updates[]

Array

Updates

flightRecords[].departure.updates[].current

String

Current field value

flightRecords[].departure.updates[].metadata.lastUpdateTime

String

UTC timestamp when update was applied (only visible when updates are grouped)

flightRecords[].departure.updates[].metadata.provider

String

Data source of this update (only visible when updates are grouped)

flightRecords[].departure.updates[].previous

String

Previous field value

flightRecords[].departure.updates[].received

String

UTC timestamp when update was received

flightRecords[].departure.updates[].updatedField

Object

Payload field which was updated

flightRecords[].departure.version

Number

FLIFO internal version number

flightRecords[].duration

String

Flight duration in minutes e.g 60

flightRecords[].flightIdentifier

Object

Flight Identifier

flightRecords[].flightIdentifier.aircraft

Object

Aircraft

flightRecords[].flightIdentifier.aircraft.callSign

String

Callsign for the aircraft type

flightRecords[].flightIdentifier.aircraft.iataCode

String

IATA code for the aircraft

flightRecords[].flightIdentifier.aircraft.icaoCode

String

ICAO code for the aircraft

flightRecords[].flightIdentifier.aircraft.model

String

Specific aircraft model details

flightRecords[].flightIdentifier.aircraft.registration

String

Aircraft regristration/tail number details e.g EIAA44W

flightRecords[].flightIdentifier.flightId

String

A value that uniquely identifies a flight within the system

flightRecords[].flightIdentifier.marketingCarriers[]

Array

Marketing Carriers

flightRecords[].flightIdentifier.marketingCarriers[].flightNumber

String

Flight number e.g 1234

flightRecords[].flightIdentifier.marketingCarriers[].iataCode

String

2-character airline IATA code e.g AA

flightRecords[].flightIdentifier.marketingCarriers[].icaoCode

String

3-character airline ICAO code e.g AAL

flightRecords[].flightIdentifier.marketingCarriers[].name

String

Name of airline e.g American Airlines

flightRecords[].flightIdentifier.operatingCarrier

Object

Operating Carrier

flightRecords[].flightIdentifier.operatingCarrier.flightNumber

String

Flight number e.g 1234

flightRecords[].flightIdentifier.operatingCarrier.iataCode

String

2-character airline IATA code e.g A

flightRecords[].flightIdentifier.operatingCarrier.icaoCode

String

3-character airline ICAO code e.g AAL

flightRecords[].flightIdentifier.operatingCarrier.name

String

Name of airline e.g American Airlines

flightRecords[].flightStats

Object

Flight Stats

flightRecords[].flightStats.baggage

Object

Baggage

flightRecords[].flightStats.baggage.cargo

String

Total number of cargo pieces

flightRecords[].flightStats.baggage.count

String

Total number of bags/pieces

flightRecords[].flightStats.baggage.load

String

Load breakdown

flightRecords[].flightStats.baggage.mail

String

Total number of mail pieces

flightRecords[].flightStats.baggage.totalWeight

String

Total weight of bags/pieces

flightRecords[].flightStats.passengers

Object

Passengers

flightRecords[].flightStats.passengers.actualBusiness

String

Actual number of business class passengers

flightRecords[].flightStats.passengers.actualEconomy

String

Actual number of economy class passengers

flightRecords[].flightStats.passengers.actualFirst

String

Actual number of 1st class passengers

flightRecords[].flightStats.passengers.actualTotal

String

Actual number of passengers

flightRecords[].flightStats.passengers.actualTransfer

String

Actual number of transfer passengers

flightRecords[].flightStats.passengers.actualTransit

String

Actual number of transit passengers

flightRecords[].flightStats.passengers.adult

String

Total number of adults

flightRecords[].flightStats.passengers.bookedBusiness

String

Total number of booked business class passengers

flightRecords[].flightStats.passengers.bookedEconomy

String

Total number of booked economy class passengers

flightRecords[].flightStats.passengers.bookedFirst

String

Total number of booked 1st class passengers

flightRecords[].flightStats.passengers.bookedTotal

String

Total number of booked passengers

flightRecords[].flightStats.passengers.child

String

Total number of children

flightRecords[].flightStats.passengers.infant

String

Total number of infants

flightRecords[].flightStats.passengers.reducedMobility

String

Total number of reduced mobility passengers e.g those requiring assistance boarding the aircraft etc.

flightRecords[].metadata.lastUpdateTime

String

UTC timestamp when update was applied

flightRecords[].metadata.provider

String

Data source of this update

flightRecords[].serviceType

String

Flight service type e.g J-Passenger, F-Cargo

groupMarketingCarriers

Object

Group Marketing Carriers

groupUpdates

Object

Group Updates

includeUpdates

Object

Include Updates

interval

Object

Interval

interval.from

Object

From

interval.from.serialVersionUID

Object

Serial Version UID

interval.to

Object

To

interval.to.serialVersionUID

Object

Serial Version UID

matchedRecords

Number

Matched Records

sessionId

Object

Session Id

sessionId.$assertionsDisabled

Object

$ assertions Disabled

sessionId.leastSigBits

Object

Least Sig Bits

sessionId.mostSigBits

Object

Most Sig Bits

sessionId.serialVersionUID

Object

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
ParameterDescription

from

Date interval start e.g 2020-01-01T12:00:00-0000. Default is current UTC date/time - 2 minutes

to

Date interval end e.g 2020-01-01T12:05:00-0000. Default is current UTC date/time - 1 minutes

includeUpdates

Show updated fields

groupMarketingCarriers

Group marketing and operating carrier flights into a single record. Default value is false

groupRecords

Group updates in a single record

verbose

Show additional information such as version

showCargo

Include cargo flights. Default value is false

Request headers
NameOptionalDescription

Content-Type

false

Content type of this request. Required value is 'application/json'

Authorization

false

Authorization header that contains the access token.

Response fields
PathTypeDescription

flightRecords[]

Array

Flight Records

flightRecords[].arrival

Object

Arrival

flightRecords[].arrival.actual

String

The actual local departure/arrival time for this flight e.g 2020-01-22T12:00:00+03:00

flightRecords[].arrival.airport

Object

Airport

flightRecords[].arrival.airport.city

String

The city in which the airport is located e.g New York

flightRecords[].arrival.airport.cityText

String

The city in which the airport is located e.g New York

flightRecords[].arrival.airport.iataCode

String

3-character airport IATA code e.g JFK

flightRecords[].arrival.airport.icaoCode

String

4-character airport ICAO code e.g KJFK

flightRecords[].arrival.airport.name

String

The name of the airport e.g John F Kennedy International Airport

flightRecords[].arrival.carousel

String

Expected carousel(s) for baggage reclaim

flightRecords[].arrival.carouselSlots[]

Array

Carousel Slots

flightRecords[].arrival.carouselSlots[].area

String

Location details of the slot resource i.e check-in desks1-20, Gate 2C etc

flightRecords[].arrival.carouselSlots[].endTime

String

End time for the slot activity e.g check-in desk closed

flightRecords[].arrival.carouselSlots[].externalName

String

Name used to identify the slot

flightRecords[].arrival.carouselSlots[].name

String

Name used to identify the slot internally

flightRecords[].arrival.carouselSlots[].startTime

String

Start time for the slot activity e.g check-in desk opened

flightRecords[].arrival.checkIn

String

Check-in desk details e.g CK-1

flightRecords[].arrival.checkinSlots[]

Array

Checkin Slots

flightRecords[].arrival.checkinSlots[].area

String

Location details of the slot resource i.e check-in desks1-20, Gate 2C etc

flightRecords[].arrival.checkinSlots[].endTime

String

End time for the slot activity e.g check-in desk closed

flightRecords[].arrival.checkinSlots[].externalName

String

Name used to identify the slot

flightRecords[].arrival.checkinSlots[].name

String

Name used to identify the slot internally

flightRecords[].arrival.checkinSlots[].startTime

String

Start time for the slot activity e.g check-in desk opened

flightRecords[].arrival.chute

String

Baggage chute details e.g CH-2

flightRecords[].arrival.chuteSlots[]

Array

Chute Slots

flightRecords[].arrival.chuteSlots[].area

String

Location details of the slot resource i.e check-in desks1-20, Gate 2C etc

flightRecords[].arrival.chuteSlots[].endTime

String

End time for the slot activity e.g check-in desk closed

flightRecords[].arrival.chuteSlots[].externalName

String

Name used to identify the slot

flightRecords[].arrival.chuteSlots[].name

String

Name used to identify the slot internally

flightRecords[].arrival.chuteSlots[].startTime

String

Start time for the slot activity e.g check-in desk opened

flightRecords[].arrival.customProperties[]

Array

Custom Properties

flightRecords[].arrival.customProperties[].key

String

Key value used to identify a custom property

flightRecords[].arrival.customProperties[].value

String

The value of a custom property

flightRecords[].arrival.diversion

Object

Flight Diversion Details.

flightRecords[].arrival.diversion.original

Object

Flight Diversion original record

flightRecords[].arrival.diversion.original.airport

Object

Airport

flightRecords[].arrival.diversion.original.airport.city

String

The city in which the airport is located e.g New York

flightRecords[].arrival.diversion.original.airport.cityText

String

The city in which the airport is located e.g New York

flightRecords[].arrival.diversion.original.airport.iataCode

String

3-character airport IATA code e.g JFK

flightRecords[].arrival.diversion.original.airport.icaoCode

String

4-character airport ICAO code e.g KJFK

flightRecords[].arrival.diversion.original.airport.name

String

The name of the airport e.g John F Kennedy International Airport

flightRecords[].arrival.diversion.original.flightNumber

String

Diversion flight original flight number

flightRecords[].arrival.diversion.original.iataCode

String

Diversion flight original airline iata code

flightRecords[].arrival.diversion.original.icaoCode

String

Diversion flight original airline icao code

flightRecords[].arrival.diversion.original.name

String

Diversion flight original airline name

flightRecords[].arrival.diversion.original.scheduled

String

Diversion flight original scheduled date of operation

flightRecords[].arrival.diversion.recovery

Object

Flight Diversion recovery record

flightRecords[].arrival.diversion.recovery.airport

Object

Airport

flightRecords[].arrival.diversion.recovery.airport.city

String

The city in which the airport is located e.g New York

flightRecords[].arrival.diversion.recovery.airport.cityText

String

The city in which the airport is located e.g New York

flightRecords[].arrival.diversion.recovery.airport.iataCode

String

3-character airport IATA code e.g JFK

flightRecords[].arrival.diversion.recovery.airport.icaoCode

String

4-character airport ICAO code e.g KJFK

flightRecords[].arrival.diversion.recovery.airport.name

String

The name of the airport e.g John F Kennedy International Airport

flightRecords[].arrival.diversion.recovery.flightNumber

String

Diversion flight recovery flight number

flightRecords[].arrival.diversion.recovery.iataCode

String

Diversion flight recovery airline iata code

flightRecords[].arrival.diversion.recovery.icaoCode

String

Diversion flight recovery airline icao code

flightRecords[].arrival.diversion.recovery.name

String

Diversion flight recovery airline name

flightRecords[].arrival.diversion.recovery.scheduled

String

Diversion flight recovery scheduled date of operation

flightRecords[].arrival.estimated

String

The latest estimated local departure/arrival time for this flight e.g 2020-01-22T12:00:00+03:00

flightRecords[].arrival.events

Object

Flight events.

flightRecords[].arrival.events.AIBT

String

The actual local time at which the aircraft arrived at the gate

flightRecords[].arrival.events.ALDT

String

The actual local time at which the aircraft landed on the runway

flightRecords[].arrival.events.AOBT

String

The actual local time at which the aircraft left the gate

flightRecords[].arrival.events.ATOT

String

The actual local time at which the aircraft left the runway

flightRecords[].arrival.events.EIBT

String

The estimated local time at which the aircraft is expected at the gate

flightRecords[].arrival.events.ELDT

String

The estimated local time at which the aircraft is expected to land on the runway

flightRecords[].arrival.events.EOBT

String

The estimated local time at which the aircraft is expected to leave the gate

flightRecords[].arrival.events.ETOT

String

The estimated local time at which the aircraft is expected to leave the runway

flightRecords[].arrival.events.TOBT

String

The local time at which the aircraft is targeted to leave the gate

flightRecords[].arrival.events.TTOT

String

The local time at which the aircraft is targeted to leave the runway

flightRecords[].arrival.gate

String

The flights departure/arrival gate e.g C1

flightRecords[].arrival.gateRemark

String

Arrival gate remark

flightRecords[].arrival.gateRemarkText

String

Gate remark text when applicable e.g Boarding at 21:00

flightRecords[].arrival.gateSlots[]

Array

Gate Slots

flightRecords[].arrival.gateSlots[].area

String

Location details of the slot resource i.e check-in desks1-20, Gate 2C etc

flightRecords[].arrival.gateSlots[].endTime

String

End time for the slot activity e.g check-in desk closed

flightRecords[].arrival.gateSlots[].externalName

String

Name used to identify the slot

flightRecords[].arrival.gateSlots[].name

String

Name used to identify the slot internally

flightRecords[].arrival.gateSlots[].startTime

String

Start time for the slot activity e.g check-in desk opened

flightRecords[].arrival.route[]

Array

Route

flightRecords[].arrival.route[].iataCode

String

3-character airport IATA code

flightRecords[].arrival.route[].icaoCode

String

4-character airport ICAO code

flightRecords[].arrival.route[].sequenceNumber

String

Value used to identify the routes position within an entire flight route e.g leg 0, leg 1, leg 2 etc

flightRecords[].arrival.scheduled

String

The published scheduled local departure/arrival time for this flight e.g 2020-01-22T12:00:00+03:00

flightRecords[].arrival.stand

String

Aircraft stand details e.g S12

flightRecords[].arrival.standSlots[]

Array

Stand Slots

flightRecords[].arrival.standSlots[].area

String

Location details of the slot resource i.e check-in desks1-20, Gate 2C etc

flightRecords[].arrival.standSlots[].endTime

String

End time for the slot activity e.g check-in desk closed

flightRecords[].arrival.standSlots[].externalName

String

Name used to identify the slot

flightRecords[].arrival.standSlots[].name

String

Name used to identify the slot internally

flightRecords[].arrival.standSlots[].startTime

String

Start time for the slot activity e.g check-in desk opened

flightRecords[].arrival.status

String

The current status code for this flight e.g SC, DP

flightRecords[].arrival.statusText

String

The current status text for this flight e.g Scheduled, Departed

flightRecords[].arrival.terminal

String

The flights departure/arrival terminal e.g T1

flightRecords[].arrival.updates[]

Array

Updates

flightRecords[].arrival.updates[].current

String

Current field value

flightRecords[].arrival.updates[].metadata.lastUpdateTime

String

UTC timestamp when update was applied (only visible when updates are grouped)

flightRecords[].arrival.updates[].metadata.provider

String

Data source of this update (only visible when updates are grouped)

flightRecords[].arrival.updates[].previous

String

Previous field value

flightRecords[].arrival.updates[].received

String

UTC timestamp when update was received

flightRecords[].arrival.updates[].updatedField

Object

Payload field which was updated

flightRecords[].arrival.version

Number

FLIFO internal version number

flightRecords[].departure

Object

Departure

flightRecords[].departure.actual

String

The actual local departure/arrival time for this flight e.g 2020-01-22T12:00:00+03:00

flightRecords[].departure.airport

Object

Airport

flightRecords[].departure.airport.city

String

The city in which the airport is located e.g New York

flightRecords[].departure.airport.cityText

String

The city in which the airport is located e.g New York

flightRecords[].departure.airport.iataCode

String

3-character airport IATA code e.g JFK

flightRecords[].departure.airport.icaoCode

String

4-character airport ICAO code e.g KJFK

flightRecords[].departure.airport.name

String

The name of the airport e.g John F Kennedy International Airport

flightRecords[].departure.carousel

String

Expected carousel(s) for baggage reclaim

flightRecords[].departure.carouselSlots[]

Array

Carousel Slots

flightRecords[].departure.carouselSlots[].area

String

Location details of the slot resource i.e check-in desks1-20, Gate 2C etc

flightRecords[].departure.carouselSlots[].endTime

String

End time for the slot activity e.g check-in desk closed

flightRecords[].departure.carouselSlots[].externalName

String

Name used to identify the slot

flightRecords[].departure.carouselSlots[].name

String

Name used to identify the slot internally

flightRecords[].departure.carouselSlots[].startTime

String

Start time for the slot activity e.g check-in desk opened

flightRecords[].departure.checkIn

String

Check-in desk details e.g CK-1

flightRecords[].departure.checkinSlots[]

Array

Checkin Slots

flightRecords[].departure.checkinSlots[].area

String

Location details of the slot resource i.e check-in desks1-20, Gate 2C etc

flightRecords[].departure.checkinSlots[].endTime

String

End time for the slot activity e.g check-in desk closed

flightRecords[].departure.checkinSlots[].externalName

String

Name used to identify the slot

flightRecords[].departure.checkinSlots[].name

String

Name used to identify the slot internally

flightRecords[].departure.checkinSlots[].startTime

String

Start time for the slot activity e.g check-in desk opened

flightRecords[].departure.chute

String

Baggage chute details e.g CH-2

flightRecords[].departure.chuteSlots[]

Array

Chute Slots

flightRecords[].departure.chuteSlots[].area

String

Location details of the slot resource i.e check-in desks1-20, Gate 2C etc

flightRecords[].departure.chuteSlots[].endTime

String

End time for the slot activity e.g check-in desk closed

flightRecords[].departure.chuteSlots[].externalName

String

Name used to identify the slot

flightRecords[].departure.chuteSlots[].name

String

Name used to identify the slot internally

flightRecords[].departure.chuteSlots[].startTime

String

Start time for the slot activity e.g check-in desk opened

flightRecords[].departure.customProperties[]

Array

Custom Properties

flightRecords[].departure.customProperties[].key

String

Key value used to identify a custom property

flightRecords[].departure.customProperties[].value

String

The value of a custom property

flightRecords[].departure.diversion

Object

Flight Diversion Details.

flightRecords[].departure.diversion.original

Object

Flight Diversion original record

flightRecords[].departure.diversion.original.airport

Object

Airport

flightRecords[].departure.diversion.original.airport.city

String

The city in which the airport is located e.g New York

flightRecords[].departure.diversion.original.airport.cityText

String

The city in which the airport is located e.g New York

flightRecords[].departure.diversion.original.airport.iataCode

String

3-character airport IATA code e.g JFK

flightRecords[].departure.diversion.original.airport.icaoCode

String

4-character airport ICAO code e.g KJFK

flightRecords[].departure.diversion.original.airport.name

String

The name of the airport e.g John F Kennedy International Airport

flightRecords[].departure.diversion.original.flightNumber

String

Diversion flight original flight number

flightRecords[].departure.diversion.original.iataCode

String

Diversion flight original airline iata code

flightRecords[].departure.diversion.original.icaoCode

String

Diversion flight original airline icao code

flightRecords[].departure.diversion.original.name

String

Diversion flight original airline name

flightRecords[].departure.diversion.original.scheduled

String

Diversion flight original scheduled date of operation

flightRecords[].departure.diversion.recovery

Object

Flight Diversion recovery record

flightRecords[].departure.diversion.recovery.airport

Object

Airport

flightRecords[].departure.diversion.recovery.airport.city

String

The city in which the airport is located e.g New York

flightRecords[].departure.diversion.recovery.airport.cityText

String

The city in which the airport is located e.g New York

flightRecords[].departure.diversion.recovery.airport.iataCode

String

3-character airport IATA code e.g JFK

flightRecords[].departure.diversion.recovery.airport.icaoCode

String

4-character airport ICAO code e.g KJFK

flightRecords[].departure.diversion.recovery.airport.name

String

The name of the airport e.g John F Kennedy International Airport

flightRecords[].departure.diversion.recovery.flightNumber

String

Diversion flight recovery flight number

flightRecords[].departure.diversion.recovery.iataCode

String

Diversion flight recovery airline iata code

flightRecords[].departure.diversion.recovery.icaoCode

String

Diversion flight recovery airline icao code

flightRecords[].departure.diversion.recovery.name

String

Diversion flight recovery airline name

flightRecords[].departure.diversion.recovery.scheduled

String

Diversion flight recovery scheduled date of operation

flightRecords[].departure.estimated

String

The latest estimated local departure/arrival time for this flight e.g 2020-01-22T12:00:00+03:00

flightRecords[].departure.events

Object

Flight events.

flightRecords[].departure.events.AIBT

String

The actual local time at which the aircraft arrived at the gate

flightRecords[].departure.events.ALDT

String

The actual local time at which the aircraft landed on the runway

flightRecords[].departure.events.AOBT

String

The actual local time at which the aircraft left the gate

flightRecords[].departure.events.ATOT

String

The actual local time at which the aircraft left the runway

flightRecords[].departure.events.EIBT

String

The estimated local time at which the aircraft is expected at the gate

flightRecords[].departure.events.ELDT

String

The estimated local time at which the aircraft is expected to land on the runway

flightRecords[].departure.events.EOBT

String

The estimated local time at which the aircraft is expected to leave the gate

flightRecords[].departure.events.ETOT

String

The estimated local time at which the aircraft is expected to leave the runway

flightRecords[].departure.events.TOBT

String

The local time at which the aircraft is targeted to leave the gate

flightRecords[].departure.events.TTOT

String

The local time at which the aircraft is targeted to leave the runway

flightRecords[].departure.gate

String

The flights departure/arrival gate e.g C1

flightRecords[].departure.gateRemark

String

Departure gate remark

flightRecords[].departure.gateRemarkText

String

Gate remark text when applicable e.g Boarding at 21:00

flightRecords[].departure.gateSlots[]

Array

Gate Slots

flightRecords[].departure.gateSlots[].area

String

Location details of the slot resource i.e check-in desks1-20, Gate 2C etc

flightRecords[].departure.gateSlots[].endTime

String

End time for the slot activity e.g check-in desk closed

flightRecords[].departure.gateSlots[].externalName

String

Name used to identify the slot

flightRecords[].departure.gateSlots[].name

String

Name used to identify the slot internally

flightRecords[].departure.gateSlots[].startTime

String

Start time for the slot activity e.g check-in desk opened

flightRecords[].departure.route[]

Array

Route

flightRecords[].departure.route[].iataCode

String

3-character airport IATA code

flightRecords[].departure.route[].icaoCode

String

4-character airport ICAO code

flightRecords[].departure.route[].sequenceNumber

String

Value used to identify the routes position within an entire flight route e.g leg 0, leg 1, leg 2 etc

flightRecords[].departure.scheduled

String

The published scheduled local departure/arrival time for this flight e.g 2020-01-22T12:00:00+03:00

flightRecords[].departure.stand

String

Aircraft stand details e.g S12

flightRecords[].departure.standSlots[]

Array

Stand Slots

flightRecords[].departure.standSlots[].area

String

Location details of the slot resource i.e check-in desks1-20, Gate 2C etc

flightRecords[].departure.standSlots[].endTime

String

End time for the slot activity e.g check-in desk closed

flightRecords[].departure.standSlots[].externalName

String

Name used to identify the slot

flightRecords[].departure.standSlots[].name

String

Name used to identify the slot internally

flightRecords[].departure.standSlots[].startTime

String

Start time for the slot activity e.g check-in desk opened

flightRecords[].departure.status

String

The current status code for this flight e.g SC, DP

flightRecords[].departure.statusText

String

The current status text for this flight e.g Scheduled, Departed

flightRecords[].departure.terminal

String

The flights departure/arrival terminal e.g T1

flightRecords[].departure.updates[]

Array

Updates

flightRecords[].departure.updates[].current

String

Current field value

flightRecords[].departure.updates[].metadata.lastUpdateTime

String

UTC timestamp when update was applied (only visible when updates are grouped)

flightRecords[].departure.updates[].metadata.provider

String

Data source of this update (only visible when updates are grouped)

flightRecords[].departure.updates[].previous

String

Previous field value

flightRecords[].departure.updates[].received

String

UTC timestamp when update was received

flightRecords[].departure.updates[].updatedField

Object

Payload field which was updated

flightRecords[].departure.version

Number

FLIFO internal version number

flightRecords[].duration

String

Flight duration in minutes e.g 60

flightRecords[].flightIdentifier

Object

Flight Identifier

flightRecords[].flightIdentifier.aircraft

Object

Aircraft

flightRecords[].flightIdentifier.aircraft.callSign

String

Callsign for the aircraft type

flightRecords[].flightIdentifier.aircraft.iataCode

String

IATA code for the aircraft

flightRecords[].flightIdentifier.aircraft.icaoCode

String

ICAO code for the aircraft

flightRecords[].flightIdentifier.aircraft.model

String

Specific aircraft model details

flightRecords[].flightIdentifier.aircraft.registration

String

Aircraft regristration/tail number details e.g EIAA44W

flightRecords[].flightIdentifier.flightId

String

A value that uniquely identifies a flight within the system

flightRecords[].flightIdentifier.marketingCarriers[]

Array

Marketing Carriers

flightRecords[].flightIdentifier.marketingCarriers[].flightNumber

String

Flight number e.g 1234

flightRecords[].flightIdentifier.marketingCarriers[].iataCode

String

2-character airline IATA code e.g AA

flightRecords[].flightIdentifier.marketingCarriers[].icaoCode

String

3-character airline ICAO code e.g AAL

flightRecords[].flightIdentifier.marketingCarriers[].name

String

Name of airline e.g American Airlines

flightRecords[].flightIdentifier.operatingCarrier

Object

Operating Carrier

flightRecords[].flightIdentifier.operatingCarrier.flightNumber

String

Flight number e.g 1234

flightRecords[].flightIdentifier.operatingCarrier.iataCode

String

2-character airline IATA code e.g A

flightRecords[].flightIdentifier.operatingCarrier.icaoCode

String

3-character airline ICAO code e.g AAL

flightRecords[].flightIdentifier.operatingCarrier.name

String

Name of airline e.g American Airlines

flightRecords[].flightStats

Object

Flight Stats

flightRecords[].flightStats.baggage

Object

Baggage

flightRecords[].flightStats.baggage.cargo

String

Total number of cargo pieces

flightRecords[].flightStats.baggage.count

String

Total number of bags/pieces

flightRecords[].flightStats.baggage.load

String

Load breakdown

flightRecords[].flightStats.baggage.mail

String

Total number of mail pieces

flightRecords[].flightStats.baggage.totalWeight

String

Total weight of bags/pieces

flightRecords[].flightStats.passengers

Object

Passengers

flightRecords[].flightStats.passengers.actualBusiness

String

Actual number of business class passengers

flightRecords[].flightStats.passengers.actualEconomy

String

Actual number of economy class passengers

flightRecords[].flightStats.passengers.actualFirst

String

Actual number of 1st class passengers

flightRecords[].flightStats.passengers.actualTotal

String

Actual number of passengers

flightRecords[].flightStats.passengers.actualTransfer

String

Actual number of transfer passengers

flightRecords[].flightStats.passengers.actualTransit

String

Actual number of transit passengers

flightRecords[].flightStats.passengers.adult

String

Total number of adults

flightRecords[].flightStats.passengers.bookedBusiness

String

Total number of booked business class passengers

flightRecords[].flightStats.passengers.bookedEconomy

String

Total number of booked economy class passengers

flightRecords[].flightStats.passengers.bookedFirst

String

Total number of booked 1st class passengers

flightRecords[].flightStats.passengers.bookedTotal

String

Total number of booked passengers

flightRecords[].flightStats.passengers.child

String

Total number of children

flightRecords[].flightStats.passengers.infant

String

Total number of infants

flightRecords[].flightStats.passengers.reducedMobility

String

Total number of reduced mobility passengers e.g those requiring assistance boarding the aircraft etc.

flightRecords[].metadata.lastUpdateTime

String

UTC timestamp when update was applied

flightRecords[].metadata.provider

String

Data source of this update

flightRecords[].serviceType

String

Flight service type e.g J-Passenger, F-Cargo

groupMarketingCarriers

Object

Group Marketing Carriers

groupUpdates

Object

Group Updates

includeUpdates

Object

Include Updates

interval

Object

Interval

interval.from

Object

From

interval.from.serialVersionUID

Object

Serial Version UID

interval.to

Object

To

interval.to.serialVersionUID

Object

Serial Version UID

matchedRecords

Number

Matched Records

sessionId

Object

Session Id

sessionId.$assertionsDisabled

Object

$ assertions Disabled

sessionId.leastSigBits

Object

Least Sig Bits

sessionId.mostSigBits

Object

Most Sig Bits

sessionId.serialVersionUID

Object

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'.

Table 1. 'view' parameter response payload formats
flifo/flightinfo/v2/flights/airport/JFK/airline/B6/direction/D?view=localflifo/flightinfo/v2/flights/airport/JFK/airline/B6/direction/D?view=full
{
"flightRecords": [
  {
    "flightIdentifier": {
      "operatingCarrier": {
        "iataCode": "B6",
        "flightNumber": "209",
        "name": "JetBlue Airways"
      },
      "aircraft": {
        "iataCode": "A321",
        "registration": "N959JB"
      },
      "flightId": "12345678"
    },
    "departure": {
      "airport": {
        "iataCode": "JFK",
        "cityText": "New York"
      },
      "scheduled": "2021-01-19T05:01:00-05:00",
      "estimated": "2021-01-19T05:01:00-05:00",
      "status": "SC",
      "statusText": "Scheduled",
      "terminal": "5",
      "gate": "21"
    },
    "serviceType": "J",
    "duration": "208"
  }
]
}
{
"flightRecords": [
  {
    "flightIdentifier": {
      "operatingCarrier": {
        "iataCode": "B6",
        "flightNumber": "209",
        "name": "JetBlue Airways"
      },
      "aircraft": {
        "iataCode": "A321",
        "registration": "N959JB"
      },
      "flightId": "12345678"
    },
    "departure": {
      "airport": {
        "iataCode": "JFK",
        "cityText": "New York"
      },
      "scheduled": "2021-01-19T05:01:00-05:00",
      "estimated": "2021-01-19T05:01:00-05:00",
      "status": "SC",
      "statusText": "Scheduled",
      "terminal": "5",
      "gate": "21"
    },
    "arrival": {
      "airport": {
        "iataCode": "SDQ",
        "cityText": "Santo Domingo"
      },
      "scheduled": "2021-01-19T09:29:00-04:00",
      "estimated": "2021-01-19T09:47:00-04:00",
      "status": "SC",
      "statusText": "Scheduled",
      "gate": "B4"
    },
    "serviceType": "J",
    "duration": "208"
  }
]
}

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

PathTypeDescription

errors

Object

Object that holds the error information

errors.error[]

Array

Array of errors

errors.error[].code

Number

API Internal Error Code

errors.error[].description

String

Error Description

errors.error[].invalidParam

String

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:

HeaderDescription

X-RateLimit-Limit

The total number of requests allowed in the current time window

X-RateLimit-Remaining

The number of requests left for the current time window

X-RateLimit-Policy

The policy describing how many request per time window are allowed

X-RateLimit-Reset

The number of seconds remaining in the current time window. Header not displayed after rate limit has been exceeded

retry-after

The epoch timestamp at which the current rate limit window resets. Header only displayed after rate limit has been exceeded

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
/aci-v1/flightDetails/{airlineCode}/{flightNumber}/{operationDate}/{departureAirportCode}/{arrivalAirportCode}
ParameterDescription

airlineCode

2-character airline IATA code or 3-character airline ICAO code

flightNumber

Flight number

operationDate

Local date of operation (yyyy-MM-dd)

departureAirportCode

3-character airport IATA code or 4-character airport ICAO code

arrivalAirportCode

3-character airport IATA code or 4-character airport ICAO code

Query parameters
ParameterDescription

suffix

Flight suffix (4A, 123B)

Request headers
NameOptionalDescription

Content-Type

false

Content type of this request. Required value is 'application/json'

Authorization

false

Authorization header that contains the access token.

Response fields
PathTypeDescription

aircraftType

Object

Aircraft Type

aircraftType.icaoCode

String

ICAO code for the aircraft

aircraftType.modelName

String

Specific aircraft model details

aircraftType.registration

String

Aircraft regristration/tail number details e.g EIAA44W

arrival

Object

Arrival

arrival.actual

Object

Actual flight arrival date/time (ISO-8601 format)

arrival.baggageClaim

Object

Baggage Claim

arrival.baggageClaim.carousel

String

The carousel for baggage claim e.g Belt 12

arrival.baggageClaim.expectedTimeOnCarousel

Object

Expected time when the baggage claim begins (ISO-8601 format)

arrival.estimated

Object

Latest estimated flight arrival date/time (ISO-8601 format)

arrival.gate

String

Arrival flight gate e.g G2

arrival.scheduled

Object

Scheduled flight arrival date/time (ISO-8601 format)

arrival.terminal

String

Arrival flight terminal e.g T1

arrival.transferInformation

String

Transfer information for arriving passengers

arrivalAirport

String

3-character arrival airport IATA code e.g LAX

codeShares[]

Array

Code Shares

codeShares[].airlineCode

String

2-character airline IATA code e.g AA

codeShares[].suffix

String

Track/Flight number suffix e.g A

codeShares[].trackNumber

String

Track/Flight number for the flight e.g 1234

departure

Object

Departure

departure.actual

Object

Actual flight departure date/time (ISO-8601 format)

departure.boardingTime[]

Array

Boarding Time

departure.boardingTime[].bookingClass

String

Boarding time per travel class

departure.boardingTime[].time

Object

Boarding date/time (ISO-8601 format)

departure.checkinInfo

Object

Checkin Info

departure.checkinInfo.additionalInfo

String

Additional information about the check-in process

departure.checkinInfo.checkInBeginTime

Object

The time when check-in procedure starts for the flight (ISO-8601 format)

departure.checkinInfo.checkInEndTime

Object

The time when check-in procedure ends for the flight (ISO-8601 format)

departure.checkinInfo.checkinLocation

String

The area of check-in facilities for the flight

departure.estimated

Object

Latest estimated flight departure date/time (ISO-8601 format)

departure.gate

String

Departure flight gate e.g G2

departure.scheduled

Object

Scheduled flight departure date/time (ISO-8601 format)

departure.terminal

String

Departure flight terminal e.g T1

departureAirport

String

3-character departure airport IATA code e.g JFK

flightNumber

Object

Flight Number

flightNumber.airlineCode

String

2-character airline IATA code e.g AA

flightNumber.suffix

String

Track/Flight number suffix e.g A

flightNumber.trackNumber

String

Track/Flight number for the flight e.g 1234

flightStatus

Object

Flight Status

lastUpdate

Object

Time stamp of the most recent update received for this flight

operatingAirline

Object

Operating Airline

operatingAirline.iataCode

String

2-character airline IATA code e.g AA

operatingAirline.icaoCode

String

3-character airline ICAO code e.g AAL

operatingAirline.name

String

Name of airline e.g American Airlines

originDate

Object

Scheduled flight departure date (YYYY-MM-DD)

via[]

Array

Via

via[].arrival

Object

Arrival

via[].arrival.actual

Object

Actual flight arrival date/time (ISO-8601 format)

via[].arrival.baggageClaim

Object

Baggage Claim

via[].arrival.baggageClaim.carousel

String

The carousel for baggage claim e.g Belt 12

via[].arrival.baggageClaim.expectedTimeOnCarousel

Object

Expected time when the baggage claim begins (ISO-8601 format)

via[].arrival.estimated

Object

Latest estimated flight arrival date/time (ISO-8601 format)

via[].arrival.gate

String

Arrival flight gate e.g G2

via[].arrival.scheduled

Object

Scheduled flight arrival date/time (ISO-8601 format)

via[].arrival.terminal

String

Arrival flight terminal e.g T1

via[].arrival.transferInformation

String

Transfer information for arriving passengers

via[].departure

Object

Departure

via[].departure.actual

Object

Actual flight departure date/time (ISO-8601 format)

via[].departure.boardingTime[]

Array

Boarding Time

via[].departure.boardingTime[].bookingClass

String

Boarding time per travel class

via[].departure.boardingTime[].time

Object

Boarding date/time (ISO-8601 format)

via[].departure.checkinInfo

Object

Checkin Info

via[].departure.checkinInfo.additionalInfo

String

Additional information about the check-in process

via[].departure.checkinInfo.checkInBeginTime

Object

The time when check-in procedure starts for the flight (ISO-8601 format)

via[].departure.checkinInfo.checkInEndTime

Object

The time when check-in procedure ends for the flight (ISO-8601 format)

via[].departure.checkinInfo.checkinLocation

String

The area of check-in facilities for the flight

via[].departure.estimated

Object

Latest estimated flight departure date/time (ISO-8601 format)

via[].departure.gate

String

Departure flight gate e.g G2

via[].departure.scheduled

Object

Scheduled flight departure date/time (ISO-8601 format)

via[].departure.terminal

String

Departure flight terminal e.g T1

via[].viaAirport

String

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
/aci-v1/flight/{airportCode}/{direction}
ParameterDescription

airportCode

3-character airport IATA code or 4-character airport ICAO code

direction

Direction field (arrival/departure)

Query parameters
ParameterDescription

length

Length

offset

Offset

timeRange

Time range in hours

startTime

Start time

Request headers
NameOptionalDescription

Content-Type

false

Content type of this request. Required value is 'application/json'

Authorization

false

Authorization header that contains the access token.

Response fields
PathTypeDescription

[].aircraftType

Object

Aircraft Type

[].aircraftType.icaoCode

String

ICAO code for the aircraft

[].aircraftType.modelName

String

Specific aircraft model details

[].aircraftType.registration

String

Aircraft regristration/tail number details e.g EIAA44W

[].arrival

Object

Arrival

[].arrival.actual

Object

Actual flight arrival date/time (ISO-8601 format)

[].arrival.baggageClaim

Object

Baggage Claim

[].arrival.baggageClaim.carousel

String

The carousel for baggage claim e.g Belt 12

[].arrival.baggageClaim.expectedTimeOnCarousel

Object

Expected time when the baggage claim begins (ISO-8601 format)

[].arrival.estimated

Object

Latest estimated flight arrival date/time (ISO-8601 format)

[].arrival.gate

String

Arrival flight gate e.g G2

[].arrival.scheduled

Object

Scheduled flight arrival date/time (ISO-8601 format)

[].arrival.terminal

String

Arrival flight terminal e.g T1

[].arrival.transferInformation

String

Transfer information for arriving passengers

[].arrivalAirport

String

3-character arrival airport IATA code e.g LAX

[].codeShares[]

Array

Code Shares

[].codeShares[].airlineCode

String

2-character airline IATA code e.g AA

[].codeShares[].suffix

String

Track/Flight number suffix e.g A

[].codeShares[].trackNumber

String

Track/Flight number for the flight e.g 1234

[].departure

Object

Departure

[].departure.actual

Object

Actual flight departure date/time (ISO-8601 format)

[].departure.boardingTime[]

Array

Boarding Time

[].departure.boardingTime[].bookingClass

String

Boarding time per travel class

[].departure.boardingTime[].time

Object

Boarding date/time (ISO-8601 format)

[].departure.checkinInfo

Object

Checkin Info

[].departure.checkinInfo.additionalInfo

String

Additional information about the check-in process

[].departure.checkinInfo.checkInBeginTime

Object

The time when check-in procedure starts for the flight (ISO-8601 format)

[].departure.checkinInfo.checkInEndTime

Object

The time when check-in procedure ends for the flight (ISO-8601 format)

[].departure.checkinInfo.checkinLocation

String

The area of check-in facilities for the flight

[].departure.estimated

Object

Latest estimated flight departure date/time (ISO-8601 format)

[].departure.gate

String

Departure flight gate e.g G2

[].departure.scheduled

Object

Scheduled flight departure date/time (ISO-8601 format)

[].departure.terminal

String

Departure flight terminal e.g T1

[].departureAirport

String

3-character departure airport IATA code e.g JFK

[].flightNumber

Object

Flight Number

[].flightNumber.airlineCode

String

2-character airline IATA code e.g AA

[].flightNumber.suffix

String

Track/Flight number suffix e.g A

[].flightNumber.trackNumber

String

Track/Flight number for the flight e.g 1234

[].flightStatus

Object

Flight Status

[].lastUpdate

Object

Time stamp of the most recent update received for this flight

[].operatingAirline

Object

Operating Airline

[].operatingAirline.iataCode

String

2-character airline IATA code e.g AA

[].operatingAirline.icaoCode

String

3-character airline ICAO code e.g AAL

[].operatingAirline.name

String

Name of airline e.g American Airlines

[].originDate

Object

Scheduled flight departure date (YYYY-MM-DD)

[].via[]

Array

Via

[].via[].arrival

Object

Arrival

[].via[].arrival.actual

Object

Actual flight arrival date/time (ISO-8601 format)

[].via[].arrival.baggageClaim

Object

Baggage Claim

[].via[].arrival.baggageClaim.carousel

String

The carousel for baggage claim e.g Belt 12

[].via[].arrival.baggageClaim.expectedTimeOnCarousel

Object

Expected time when the baggage claim begins (ISO-8601 format)

[].via[].arrival.estimated

Object

Latest estimated flight arrival date/time (ISO-8601 format)

[].via[].arrival.gate

String

Arrival flight gate e.g G2

[].via[].arrival.scheduled

Object

Scheduled flight arrival date/time (ISO-8601 format)

[].via[].arrival.terminal

String

Arrival flight terminal e.g T1

[].via[].arrival.transferInformation

String

Transfer information for arriving passengers

[].via[].departure

Object

Departure

[].via[].departure.actual

Object

Actual flight departure date/time (ISO-8601 format)

[].via[].departure.boardingTime[]

Array

Boarding Time

[].via[].departure.boardingTime[].bookingClass

String

Boarding time per travel class

[].via[].departure.boardingTime[].time

Object

Boarding date/time (ISO-8601 format)

[].via[].departure.checkinInfo

Object

Checkin Info

[].via[].departure.checkinInfo.additionalInfo

String

Additional information about the check-in process

[].via[].departure.checkinInfo.checkInBeginTime

Object

The time when check-in procedure starts for the flight (ISO-8601 format)

[].via[].departure.checkinInfo.checkInEndTime

Object

The time when check-in procedure ends for the flight (ISO-8601 format)

[].via[].departure.checkinInfo.checkinLocation

String

The area of check-in facilities for the flight

[].via[].departure.estimated

Object

Latest estimated flight departure date/time (ISO-8601 format)

[].via[].departure.gate

String

Departure flight gate e.g G2

[].via[].departure.scheduled

Object

Scheduled flight departure date/time (ISO-8601 format)

[].via[].departure.terminal

String

Departure flight terminal e.g T1

[].via[].viaAirport

String

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

CodeDescriptionStatus DescriptionDeparture StatusArrival StatusCan 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.