Skip to main content

SITA Historical Flight Status API

SITA Advanced Data Services

version 1.1.0-SNAPSHOT

1 Revision History

Date Version Description Author

8 May 2021

1.0

Initial version

M Freitas

31 July 2021

1.1

Adding metadata fields with provider and last update time

M Freitas

02 September 2021

1.2

Updated flightinfo datetime offsets to be ISO8601 compliant e.g. 01:00

D McGowan

24 November 2021

1.3

Adding flightinfo V2 endpoints

M Freitas

22 April 2022

1.4

Adding delay prediction

D McGowan

25 October 2022

1.5

Reformatting and general tidy up

L Kenny

2 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 API Key Usage

The API key will be passed in an HTTP header as follows:

  • Name of header: x-apikey

  • Value of header: The API key as generated for the application.

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

[[SITA Historical Flight Status API]]

3 SITA Historical Flight Status API

The SITA Historical Flight Status API is a REST based service which provides information about flights around the world.

A user may

  • Search for the 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

3.1 Resources

This section describes each SITA Historical 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.

3.2 Flights V2

3.2.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
/v2/flights/airline/{airlineCode}/flightNumber/{flightNumber}
Parameter Description

airlineCode

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

flightNumber

Flight number

Request parameters
Parameter Description

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
Name Description

Content-Type

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

X-apiKey

Authorization header that contains the API key.

Response fields
Path Type Description

flightRecords[].departure.route[].icaoCode

String

4-character airport ICAO code

flightRecords[].departure.gateSlots[].externalName

String

Name used to identify the slot

flightRecords[].departure.delayPrediction.minutes

String

Calculated Delay in Minutes

flightRecords[].departure.diversion.recovery.icaoCode

String

3-character airline ICAO code e.g AAL

flightRecords[].departure.diversion.original.icaoCode

String

3-character airline ICAO code e.g AAL

flightRecords[].arrival.delayPrediction.minutes

String

Calculated Delay in Minutes

flightRecords[].arrival.diversion.recovery.icaoCode

String

3-character airline ICAO code e.g AAL

flightRecords[].arrival.standSlots[].externalName

String

Name used to identify the slot

flightRecords[].arrival.status

String

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

flightRecords[].departure.route[].iataCode

String

3-character airport IATA code

flightRecords[].arrival.actual

String

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

flightRecords[].departure.delayPrediction.prediction

String

Calculated Delay Prediction

flightRecords[].departure.diversion.recovery.iataCode

String

2-character airline IATA code e.g A

flightRecords[].departure.diversion.original.iataCode

String

2-character airline IATA code e.g A

flightRecords[].arrival.delayPrediction.prediction

String

Calculated Delay Prediction

flightRecords[].arrival.standSlots[].name

String

Name used to identify the slot internally

flightRecords[].departure.customProperties[]

Array

Custom Properties

flightRecords[].departure.gateSlots[].endTime

String

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

flightRecords[].departure.checkinSlots[].endTime

String

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

flightRecords[].arrival.standSlots[]

Array

Stand Slots

flightRecords[].arrival.estimated

String

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

flightRecords[].departure.delayPrediction

Object

Flight Delay Prediction. Available for Premium Users.

flightRecords[].departure.diversion.recovery

Object

Recovery flight

flightRecords[].arrival.carouselSlots[]

Array

Carousel Slots

flightRecords[].arrival.delayPrediction

Object

Flight Delay Prediction. Available for Premium Users.

flightRecords[].departure.customProperties[].key

String

Key value used to identify a custom property

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.gateSlots[].startTime

String

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

flightRecords[].arrival.checkinSlots[].area

String

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

flightRecords[].arrival.chute

String

Baggage chute details e.g CH-2

flightRecords[].arrival.scheduled

String

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

flightRecords[].departure.diversion.recovery.scheduled

String

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

flightRecords[].departure.diversion.original.scheduled

String

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

flightRecords[].arrival.gateSlots[].endTime

String

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

flightRecords[].arrival.checkinSlots[].endTime

String

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

flightRecords[].arrival.checkIn

String

Check-in desk details e.g CK-1

flightRecords[].arrival.airport.cityText

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[].arrival.gateSlots[].startTime

String

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

flightRecords[].arrival.checkinSlots[].startTime

String

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

flightRecords[].arrival.stand

String

Aircraft stand details e.g S12

flightRecords[].arrival.airport.city

String

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

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

String

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

flightRecords[].departure.route[]

Array

Route

flightRecords[].arrival.route[].icaoCode

String

4-character airport ICAO code

flightRecords[].arrival.gateSlots[].externalName

String

Name used to identify the slot

flightRecords[].arrival.checkinSlots[].externalName

String

Name used to identify the slot

flightRecords[].arrival.carousel

String

Expected carousel(s) for baggage reclaim

flightRecords[].arrival.airport.name

String

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

flightRecords[].arrival.route[].iataCode

String

3-character airport IATA code

flightRecords[].arrival.gateSlots[].name

String

Name used to identify the slot internally

flightRecords[].arrival.checkinSlots[].name

String

Name used to identify the slot internally

flightRecords[].arrival.gateRemarkText

String

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

flightRecords[].arrival.airport.icaoCode

String

4-character airport ICAO code e.g KJFK

flightRecords[].arrival.events.estimatedLandingTime

String

Estimated Landing Time

flightRecords[].arrival.route[]

Array

Route

flightRecords[].arrival.gateSlots[]

Array

Gate Slots

flightRecords[].arrival.checkinSlots[]

Array

Checkin Slots

flightRecords[].arrival.gateRemark

String

 

flightRecords[].departure.standSlots[].area

String

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

flightRecords[].departure.gate

String

The flights departure/arrival gate e.g C1

flightRecords[].departure.airport

Object

Airport

flightRecords[].departure.chuteSlots[].area

String

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

flightRecords[].departure.carouselSlots[].area

String

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

flightRecords[].arrival.events.actualTakeOffTime

String

Actual Take Off Time

flightRecords[].arrival.chuteSlots[].area

String

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

flightRecords[].arrival.carouselSlots[].area

String

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

flightRecords[].arrival.standSlots[].area

String

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

flightRecords[].arrival.gate

String

The flights departure/arrival gate e.g C1

flightRecords[].departure.carouselSlots[].endTime

String

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

flightRecords[].departure.standSlots[].endTime

String

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

flightRecords[].departure.terminal

String

The flights departure/arrival terminal e.g T1

flightRecords[].departure

Object

Departure

flightRecords[].departure.chuteSlots[].endTime

String

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

flightRecords[].arrival.events.actualOffBlockTime

String

Actual Off Block Time

flightRecords[].arrival.chuteSlots[].endTime

String

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

flightRecords[].arrival.carouselSlots[].endTime

String

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

flightRecords[].arrival.standSlots[].endTime

String

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

flightRecords[].departure.airport.icaoCode

String

4-character airport ICAO code e.g KJFK

flightRecords[].flightStats.passengers.adult

String

Total number of adults

flightRecords[].departure.gateSlots[].name

String

Name used to identify the slot internally

flightRecords[].departure.checkinSlots[].name

String

Name used to identify the slot internally

flightRecords[].departure.gateRemarkText

String

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

flightRecords[].arrival.standSlots[].startTime

String

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

flightRecords[].arrival.events.actualInBlockTime

String

Actual In Block Time

flightRecords[].arrival.chuteSlots[].startTime

String

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

flightRecords[].arrival.carouselSlots[].startTime

String

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

flightRecords[].departure.gateRemark

String

 

flightRecords[].departure.airport.iataCode

String

3-character airport IATA code e.g JFK

flightRecords[].flightStats.passengers.reducedMobility

String

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

flightRecords[].departure.gateSlots[]

Array

Gate Slots

flightRecords[].departure.checkinSlots[]

Array

Checkin Slots

flightRecords[].departure.carouselSlots[]

Array

Carousel Slots

flightRecords[].departure.standSlots[]

Array

Stand Slots

flightRecords[].arrival.carouselSlots[].externalName

String

Name used to identify the slot

flightRecords[].arrival.events.actualLandingTime

String

Actual Landing Time

flightRecords[].arrival.chuteSlots[].externalName

String

Name used to identify the slot

flightRecords[].departure.events

Object

Events

flightRecords[].departure.chuteSlots[].name

String

Name used to identify the slot internally

flightRecords[].departure.carouselSlots[].name

String

Name used to identify the slot internally

flightRecords[].departure.gateSlots[].area

String

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

flightRecords[].departure.checkinSlots[].area

String

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

flightRecords[].arrival.chuteSlots[].name

String

Name used to identify the slot internally

flightRecords[].arrival.carouselSlots[].name

String

Name used to identify the slot internally

flightRecords[].arrival.events

Object

Events

flightRecords[].departure.customProperties[].value

String

The value of a custom property

flightRecords[].departure.chuteSlots[]

Array

Chute Slots

flightRecords[].departure.status

String

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

flightRecords[].arrival.customProperties[].value

String

The value of a custom property

flightRecords[].arrival.chuteSlots[]

Array

Chute Slots

flightRecords[].departure.chuteSlots[].startTime

String

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

flightRecords[].departure.carouselSlots[].startTime

String

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

flightRecords[].departure.standSlots[].startTime

String

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

flightRecords[].departure.statusText

String

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

flightRecords[].departure.events.AIBT

String

The actual local time at which the aircraft arrived at the gate e.g 2020-01-22T12:00:00+03:00

flightRecords[].departure.standSlots[].name

String

Name used to identify the slot internally

flightRecords[].arrival.customProperties[].key

String

Key value used to identify a custom property

flightRecords[].arrival.gateSlots[].area

String

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

flightRecords[].departure.events.ALDT

String

The actual local time at which the aircraft landed on the runway e.g 2020-01-22T12:00:00+03:00

flightRecords[].departure.chuteSlots[].externalName

String

Name used to identify the slot

flightRecords[].departure.carouselSlots[].externalName

String

Name used to identify the slot

flightRecords[].departure.standSlots[].externalName

String

Name used to identify the slot

flightRecords[].arrival.customProperties[]

Array

Custom Properties

flightRecords[].departure.actual

String

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

flightRecords[].flightStats.baggage.totalWeight

String

Total weight of bags/pieces

flightRecords[].flightStats.passengers.actualFirst

String

Actual number of 1st class passengers

flightRecords[].flightIdentifier.aircraft.iataCode

String

IATA code for the aircraft

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[].departure.estimated

String

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

flightRecords[].flightStats.baggage.load

String

Load breakdown

flightRecords[].flightStats.passengers.actualTotal

String

Actual number of passengers

flightRecords[].flightIdentifier.aircraft

Object

Aircraft

flightRecords[].flightStats.baggage.mail

String

Total number of mail pieces

flightRecords[].flightStats.passengers.actualEconomy

String

Actual number of economy class passengers

flightRecords[].flightIdentifier.aircraft.model

String

Specific aircraft model details

flightRecords[].arrival.diversion.original.flightNumber

String

Flight number e.g 1234

flightRecords[].flightStats.baggage.cargo

String

Total number of cargo pieces

flightRecords[].flightStats.passengers.actualBusiness

String

Actual number of business class passengers

flightRecords[].flightIdentifier.aircraft.icaoCode

String

ICAO code for the aircraft

flightRecords[].arrival.diversion.original.icaoCode

String

3-character airline ICAO code e.g AAL

flightRecords[].flightIdentifier.marketingCarriers[].icaoCode

String

3-character airline ICAO code e.g AAL

flightRecords[].flightStats.passengers.bookedFirst

String

Total number of booked 1st class passengers

flightRecords[].departure.checkinSlots[].startTime

String

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

flightRecords[].departure.stand

String

Aircraft stand details e.g S12

flightRecords[].departure.airport.city

String

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

flightRecords[].flightStats.passengers.infant

String

Total number of infants

flightRecords[].arrival.diversion.recovery.iataCode

String

2-character airline IATA code e.g A

flightRecords[].arrival.diversion.original.iataCode

String

2-character airline IATA code e.g A

flightRecords[].flightStats.passengers.child

String

Total number of children

flightRecords[].flightStats.passengers.bookedTotal

String

Total number of booked passengers

flightRecords[].departure.checkinSlots[].externalName

String

Name used to identify the slot

flightRecords[].departure.carousel

String

Expected carousel(s) for baggage reclaim

flightRecords[].departure.airport.name

String

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

flightRecords[].departure.diversion.original

Object

Original flight

flightRecords[].arrival.diversion.recovery

Object

Recovery flight

flightRecords[].arrival.diversion.original

Object

Original flight

flightRecords[].departure.chute

String

Baggage chute details e.g CH-2

flightRecords[].flightIdentifier.marketingCarriers[]

Array

Marketing Carriers

flightRecords[].departure.scheduled

String

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

flightRecords[].flightStats.baggage.count

String

Total number of bags/pieces

flightRecords[].flightStats.passengers.bookedEconomy

String

Total number of booked economy class passengers

flightRecords[].flightIdentifier.marketingCarriers[].name

String

Name of airline e.g American Airlines

flightRecords[].departure.diversion

Object

Diversion

flightRecords[].arrival.diversion.recovery.scheduled

String

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

flightRecords[].arrival.diversion.original.scheduled

String

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

flightRecords[].arrival.diversion

Object

Diversion

flightRecords[].flightIdentifier.marketingCarriers[].iataCode

String

2-character airline IATA code e.g AA

flightRecords[].flightIdentifier.marketingCarriers[].flightNumber

String

Flight number e.g 1234

flightRecords[].departure.checkIn

String

Check-in desk details e.g CK-1

flightRecords[].departure.airport.cityText

String

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

flightRecords[].flightStats.baggage

Object

Baggage

flightRecords[].flightStats.passengers.bookedBusiness

String

Total number of booked business class passengers

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

String

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

flightRecords[].departure.events.TTOT

String

The local time at which the aircraft is targeted to leave the runway e.g 2020-01-22T12:00:00+03:00

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

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.events.targetTakeOffTime

String

Target Take Off Time

flightRecords[].flightIdentifier.operatingCarrier.flightNumber

String

Flight number e.g 1234

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

String

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

flightRecords[].departure.events.TOBT

String

The local time at which the aircraft is targeted to leave the gate e.g 2020-01-22T12:00:00+03:00

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

String

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

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

String

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

flightRecords[].arrival.events.targetOffBlockTime

String

Target Off Block Time

flightRecords[].flightIdentifier.operatingCarrier.name

String

Name of airline e.g American Airlines

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

String

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

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

String

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

flightRecords[].metadata.lastUpdateTime

String

UTC timestamp when last update update was applied to this flight

flightRecords[].departure.events.ETOT

String

The estimated local time at which the aircraft is expected to leave the runway e.g 2020-01-22T12:00:00+03:00

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

String

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

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

String

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

flightRecords[].arrival.events.estimatedTakeOffTime

String

Estimated Take Off Time

flightRecords[].flightIdentifier.operatingCarrier.iataCode

String

2-character airline IATA code e.g AA

flightRecords[].arrival.events.estimatedOffBlockTime

String

Estimated Off Block Time

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

String

4-character airport ICAO code e.g KJFK

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

String

4-character airport ICAO code e.g KJFK

flightRecords[].metadata.provider

String

Data source of the last update applied to this flight

flightRecords[].departure.events.EOBT

String

The estimated local time at which the aircraft is expected to leave the gate e.g 2020-01-22T12:00:00+03:00

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

String

4-character airport ICAO code e.g KJFK

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

String

4-character airport ICAO code e.g KJFK

flightRecords[].flightIdentifier.operatingCarrier.icaoCode

String

3-character airline ICAO code e.g AAL

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

String

3-character airport IATA code e.g JFK

flightRecords[].arrival.events.estimatedInBlockTime

String

Estimated In Block Time

flightRecords[].arrival.airport.iataCode

String

3-character airport IATA code e.g JFK

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

String

3-character airport IATA code e.g JFK

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

String

3-character airport IATA code e.g JFK

flightRecords[].metadata

Object

Metadata

flightRecords[].departure.events.EIBT

String

The estimated local time at which the aircraft is expected at the gate e.g 2020-01-22T12:00:00+03:00

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

String

3-character airport IATA code e.g JFK

flightRecords[].flightStats.passengers.actualTransit

String

Actual number of transit passengers

flightRecords[].flightIdentifier.aircraft.callSign

String

Call-sign for the aircraft type

flightRecords[].flightIdentifier

Object

Flight Identifier

flightRecords[].departure.events.ELDT

String

The estimated local time at which the aircraft is expected to land on the runway e.g 2020-01-22T12:00:00+03:00

flightRecords[].arrival.diversion.recovery.airport

Object

Airport

flightRecords[].arrival.diversion.original.airport

Object

Airport

flightRecords[].arrival.airport

Object

Airport

flightRecords[].departure.diversion.recovery.airport

Object

Airport

flightRecords[].departure.diversion.original.airport

Object

Airport

flightRecords[].duration

String

Flight duration in minutes e.g 60

flightRecords[].flightStats.passengers.actualTransfer

String

Actual number of transfer passengers

flightRecords[].flightIdentifier.aircraft.registration

String

Aircraft registration/tail number details e.g EIAA44W

flightRecords[].flightIdentifier.operatingCarrier

Object

Operating Carrier

flightRecords[].departure.diversion.original.name

String

Name of airline e.g American Airlines

flightRecords[].serviceType

String

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

flightRecords[].departure.events.ATOT

String

The actual local time at which the aircraft left the runway e.g 2020-01-22T12:00:00+03:00

flightRecords[].arrival.diversion.recovery.name

String

Name of airline e.g American Airlines

flightRecords[].arrival.diversion.original.name

String

Name of airline e.g American Airlines

flightRecords[].arrival.terminal

String

The flights departure/arrival terminal e.g T1

flightRecords[].arrival

Object

Arrival

flightRecords[].departure.diversion.recovery.name

String

Name of airline e.g American Airlines

flightRecords[].flightStats.passengers

Object

Passengers

flightRecords[].departure.diversion.recovery.flightNumber

String

Flight number e.g 1234

flightRecords[].departure.diversion.original.flightNumber

String

Flight number e.g 1234

flightRecords[].arrival.delayPrediction.message

String

A message related to the prediction

flightRecords[].departure.events.AOBT

String

The actual local time at which the aircraft left the gate e.g 2020-01-22T12:00:00+03:00

flightRecords[].arrival.diversion.recovery.flightNumber

String

Flight number e.g 1234

flightRecords[].arrival.statusText

String

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

flightRecords[].departure.delayPrediction.message

String

A message related to the prediction

flightRecords[].flightStats

Object

Flight Stats

flightRecords[]

Array

Flight Records

Curl request
$ curl 'https://historical.api.aero/historical/v2/flights/airline/UL/flightNumber/1512?operationDate=2021-04-01' -i -X GET \
    -H 'Content-Type: application/json' \
    -H 'X-apiKey: Insert your API key here'
HTTP response
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 3330

{
  "flightRecords" : [ {
    "flightIdentifier" : {
      "operatingCarrier" : {
        "iataCode" : "UL",
        "flightNumber" : "1512",
        "name" : "SriLankan Airlines"
      },
      "aircraft" : {
        "iataCode" : "321",
        "icaoCode" : "A321",
        "model" : "A321",
        "registration" : "4RAND"
      }
    },
    "flightStats" : {
      "passengers" : {
        "bookedTotal" : "120",
        "adult" : "109",
        "child" : "2",
        "infant" : "2"
      },
      "baggage" : {
        "count" : "235",
        "load" : "3661",
        "cargo" : "0",
        "mail" : "0"
      }
    },
    "departure" : {
      "airport" : {
        "iataCode" : "CMB",
        "cityText" : "Colombo"
      },
      "scheduled" : "2021-04-01T12:25:00+04:00",
      "estimated" : "2021-04-01T14:43:00+05:30",
      "actual" : "2021-04-01T13:48:00+05:30",
      "status" : "DP",
      "statusText" : "Departed",
      "terminal" : "T1",
      "gate" : "C3",
      "stand" : "401R",
      "checkIn" : "F10",
      "chute" : "S1",
      "standSlots" : [ {
        "name" : "401R",
        "externalName" : "401R",
        "startTime" : "2021-04-01T11:06:00+04:00",
        "endTime" : "2021-04-01T12:18:00+04:00",
        "area" : "Sector 4C"
      } ],
      "checkinSlots" : [ {
        "name" : "F10",
        "externalName" : "F10",
        "startTime" : "2021-04-01T07:40:00+04:00",
        "endTime" : "2021-04-01T11:25:00+04:00",
        "area" : "Check-In F"
      }, {
        "name" : "F11",
        "externalName" : "F11",
        "startTime" : "2021-04-01T07:40:00+04:00",
        "endTime" : "2021-04-01T11:25:00+04:00",
        "area" : "Check-In F"
      }, {
        "name" : "F12",
        "externalName" : "F12",
        "startTime" : "2021-04-01T07:40:00+04:00",
        "endTime" : "2021-04-01T11:25:00+04:00",
        "area" : "Check-In F"
      }, {
        "name" : "F8",
        "externalName" : "F8",
        "startTime" : "2021-04-01T07:40:00+04:00",
        "endTime" : "2021-04-01T11:25:00+04:00",
        "area" : "Check-In F"
      }, {
        "name" : "F9",
        "externalName" : "F9",
        "startTime" : "2021-04-01T07:40:00+04:00",
        "endTime" : "2021-04-01T11:25:00+04:00",
        "area" : "Check-In F"
      } ],
      "gateSlots" : [ {
        "name" : "C3",
        "externalName" : "C3",
        "startTime" : "2021-04-01T11:18:00+04:00",
        "endTime" : "2021-04-01T12:18:00+04:00",
        "area" : "Pier C Contact"
      } ],
      "chuteSlots" : [ {
        "name" : "S1",
        "externalName" : "S1",
        "startTime" : "2021-04-01T09:25:00+04:00",
        "endTime" : "2021-04-01T11:25:00+04:00",
        "area" : "Chutes"
      } ],
      "route" : [ {
        "sequenceNumber" : 0
      } ],
      "customProperties" : [ {
        "key" : "S---_Status",
        "value" : "SCH"
      } ],
      "events" : {
        "AOBT" : "2021-04-01T12:18:00+04:00",
        "ATOT" : "2021-04-01T12:26:00+04:00",
        "EOBT" : "2021-04-01T13:13:00+04:00"
      },
      "delayPrediction" : {
        "minutes" : 65,
        "prediction" : "2021-04-01T13:30:00+04:00"
      }
    },
    "serviceType" : "J",
    "duration" : 255
  } ]
}

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

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

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)

Request parameters
Parameter Description

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

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
Name Description

Content-Type

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

X-apiKey

Authorization header that contains the API key.

Response fields
Path Type Description

flightRecords[].departure.route[].icaoCode

String

4-character airport ICAO code

flightRecords[].departure.gateSlots[].externalName

String

Name used to identify the slot

flightRecords[].departure.delayPrediction.minutes

String

Calculated Delay in Minutes

flightRecords[].departure.diversion.recovery.icaoCode

String

3-character airline ICAO code e.g AAL

flightRecords[].departure.diversion.original.icaoCode

String

3-character airline ICAO code e.g AAL

flightRecords[].arrival.delayPrediction.minutes

String

Calculated Delay in Minutes

flightRecords[].arrival.diversion.recovery.icaoCode

String

3-character airline ICAO code e.g AAL

flightRecords[].arrival.standSlots[].externalName

String

Name used to identify the slot

flightRecords[].arrival.status

String

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

flightRecords[].departure.route[].iataCode

String

3-character airport IATA code

flightRecords[].arrival.actual

String

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

flightRecords[].departure.delayPrediction.prediction

String

Calculated Delay Prediction

flightRecords[].departure.diversion.recovery.iataCode

String

2-character airline IATA code e.g A

flightRecords[].departure.diversion.original.iataCode

String

2-character airline IATA code e.g A

flightRecords[].arrival.delayPrediction.prediction

String

Calculated Delay Prediction

flightRecords[].arrival.standSlots[].name

String

Name used to identify the slot internally

flightRecords[].departure.customProperties[]

Array

Custom Properties

flightRecords[].departure.gateSlots[].endTime

String

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

flightRecords[].departure.checkinSlots[].endTime

String

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

flightRecords[].arrival.standSlots[]

Array

Stand Slots

flightRecords[].arrival.estimated

String

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

flightRecords[].departure.delayPrediction

Object

Flight Delay Prediction. Available for Premium Users.

flightRecords[].departure.diversion.recovery

Object

Recovery flight

flightRecords[].arrival.carouselSlots[]

Array

Carousel Slots

flightRecords[].arrival.delayPrediction

Object

Flight Delay Prediction. Available for Premium Users.

flightRecords[].departure.customProperties[].key

String

Key value used to identify a custom property

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.gateSlots[].startTime

String

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

flightRecords[].arrival.checkinSlots[].area

String

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

flightRecords[].arrival.chute

String

Baggage chute details e.g CH-2

flightRecords[].arrival.scheduled

String

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

flightRecords[].departure.diversion.recovery.scheduled

String

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

flightRecords[].departure.diversion.original.scheduled

String

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

flightRecords[].arrival.gateSlots[].endTime

String

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

flightRecords[].arrival.checkinSlots[].endTime

String

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

flightRecords[].arrival.checkIn

String

Check-in desk details e.g CK-1

flightRecords[].arrival.airport.cityText

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[].arrival.gateSlots[].startTime

String

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

flightRecords[].arrival.checkinSlots[].startTime

String

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

flightRecords[].arrival.stand

String

Aircraft stand details e.g S12

flightRecords[].arrival.airport.city

String

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

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

String

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

flightRecords[].departure.route[]

Array

Route

flightRecords[].arrival.route[].icaoCode

String

4-character airport ICAO code

flightRecords[].arrival.gateSlots[].externalName

String

Name used to identify the slot

flightRecords[].arrival.checkinSlots[].externalName

String

Name used to identify the slot

flightRecords[].arrival.carousel

String

Expected carousel(s) for baggage reclaim

flightRecords[].arrival.airport.name

String

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

flightRecords[].arrival.route[].iataCode

String

3-character airport IATA code

flightRecords[].arrival.gateSlots[].name

String

Name used to identify the slot internally

flightRecords[].arrival.checkinSlots[].name

String

Name used to identify the slot internally

flightRecords[].arrival.gateRemarkText

String

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

flightRecords[].arrival.airport.icaoCode

String

4-character airport ICAO code e.g KJFK

flightRecords[].arrival.events.estimatedLandingTime

String

Estimated Landing Time

flightRecords[].arrival.route[]

Array

Route

flightRecords[].arrival.gateSlots[]

Array

Gate Slots

flightRecords[].arrival.checkinSlots[]

Array

Checkin Slots

flightRecords[].arrival.gateRemark

String

 

flightRecords[].departure.standSlots[].area

String

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

flightRecords[].departure.gate

String

The flights departure/arrival gate e.g C1

flightRecords[].departure.airport

Object

Airport

flightRecords[].departure.chuteSlots[].area

String

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

flightRecords[].departure.carouselSlots[].area

String

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

flightRecords[].arrival.events.actualTakeOffTime

String

Actual Take Off Time

flightRecords[].arrival.chuteSlots[].area

String

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

flightRecords[].arrival.carouselSlots[].area

String

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

flightRecords[].arrival.standSlots[].area

String

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

flightRecords[].arrival.gate

String

The flights departure/arrival gate e.g C1

flightRecords[].departure.carouselSlots[].endTime

String

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

flightRecords[].departure.standSlots[].endTime

String

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

flightRecords[].departure.terminal

String

The flights departure/arrival terminal e.g T1

flightRecords[].departure

Object

Departure

flightRecords[].departure.chuteSlots[].endTime

String

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

flightRecords[].arrival.events.actualOffBlockTime

String

Actual Off Block Time

flightRecords[].arrival.chuteSlots[].endTime

String

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

flightRecords[].arrival.carouselSlots[].endTime

String

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

flightRecords[].arrival.standSlots[].endTime

String

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

flightRecords[].departure.airport.icaoCode

String

4-character airport ICAO code e.g KJFK

flightRecords[].flightStats.passengers.adult

String

Total number of adults

flightRecords[].departure.gateSlots[].name

String

Name used to identify the slot internally

flightRecords[].departure.checkinSlots[].name

String

Name used to identify the slot internally

flightRecords[].departure.gateRemarkText

String

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

flightRecords[].arrival.standSlots[].startTime

String

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

flightRecords[].arrival.events.actualInBlockTime

String

Actual In Block Time

flightRecords[].arrival.chuteSlots[].startTime

String

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

flightRecords[].arrival.carouselSlots[].startTime

String

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

flightRecords[].departure.gateRemark

String

 

flightRecords[].departure.airport.iataCode

String

3-character airport IATA code e.g JFK

flightRecords[].flightStats.passengers.reducedMobility

String

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

flightRecords[].departure.gateSlots[]

Array

Gate Slots

flightRecords[].departure.checkinSlots[]

Array

Checkin Slots

flightRecords[].departure.carouselSlots[]

Array

Carousel Slots

flightRecords[].departure.standSlots[]

Array

Stand Slots

flightRecords[].arrival.carouselSlots[].externalName

String

Name used to identify the slot

flightRecords[].arrival.events.actualLandingTime

String

Actual Landing Time

flightRecords[].arrival.chuteSlots[].externalName

String

Name used to identify the slot

flightRecords[].departure.events

Object

Events

flightRecords[].departure.chuteSlots[].name

String

Name used to identify the slot internally

flightRecords[].departure.carouselSlots[].name

String

Name used to identify the slot internally

flightRecords[].departure.gateSlots[].area

String

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

flightRecords[].departure.checkinSlots[].area

String

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

flightRecords[].arrival.chuteSlots[].name

String

Name used to identify the slot internally

flightRecords[].arrival.carouselSlots[].name

String

Name used to identify the slot internally

flightRecords[].arrival.events

Object

Events

flightRecords[].departure.customProperties[].value

String

The value of a custom property

flightRecords[].departure.chuteSlots[]

Array

Chute Slots

flightRecords[].departure.status

String

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

flightRecords[].arrival.customProperties[].value

String

The value of a custom property

flightRecords[].arrival.chuteSlots[]

Array

Chute Slots

flightRecords[].departure.chuteSlots[].startTime

String

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

flightRecords[].departure.carouselSlots[].startTime

String

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

flightRecords[].departure.standSlots[].startTime

String

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

flightRecords[].departure.statusText

String

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

flightRecords[].departure.events.AIBT

String

The actual local time at which the aircraft arrived at the gate e.g 2020-01-22T12:00:00+03:00

flightRecords[].departure.standSlots[].name

String

Name used to identify the slot internally

flightRecords[].arrival.customProperties[].key

String

Key value used to identify a custom property

flightRecords[].arrival.gateSlots[].area

String

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

flightRecords[].departure.events.ALDT

String

The actual local time at which the aircraft landed on the runway e.g 2020-01-22T12:00:00+03:00

flightRecords[].departure.chuteSlots[].externalName

String

Name used to identify the slot

flightRecords[].departure.carouselSlots[].externalName

String

Name used to identify the slot

flightRecords[].departure.standSlots[].externalName

String

Name used to identify the slot

flightRecords[].arrival.customProperties[]

Array

Custom Properties

flightRecords[].departure.actual

String

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

flightRecords[].flightStats.baggage.totalWeight

String

Total weight of bags/pieces

flightRecords[].flightStats.passengers.actualFirst

String

Actual number of 1st class passengers

flightRecords[].flightIdentifier.aircraft.iataCode

String

IATA code for the aircraft

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[].departure.estimated

String

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

flightRecords[].flightStats.baggage.load

String

Load breakdown

flightRecords[].flightStats.passengers.actualTotal

String

Actual number of passengers

flightRecords[].flightIdentifier.aircraft

Object

Aircraft

flightRecords[].flightStats.baggage.mail

String

Total number of mail pieces

flightRecords[].flightStats.passengers.actualEconomy

String

Actual number of economy class passengers

flightRecords[].flightIdentifier.aircraft.model

String

Specific aircraft model details

flightRecords[].arrival.diversion.original.flightNumber

String

Flight number e.g 1234

flightRecords[].flightStats.baggage.cargo

String

Total number of cargo pieces

flightRecords[].flightStats.passengers.actualBusiness

String

Actual number of business class passengers

flightRecords[].flightIdentifier.aircraft.icaoCode

String

ICAO code for the aircraft

flightRecords[].arrival.diversion.original.icaoCode

String

3-character airline ICAO code e.g AAL

flightRecords[].flightIdentifier.marketingCarriers[].icaoCode

String

3-character airline ICAO code e.g AAL

flightRecords[].flightStats.passengers.bookedFirst

String

Total number of booked 1st class passengers

flightRecords[].departure.checkinSlots[].startTime

String

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

flightRecords[].departure.stand

String

Aircraft stand details e.g S12

flightRecords[].departure.airport.city

String

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

flightRecords[].flightStats.passengers.infant

String

Total number of infants

flightRecords[].arrival.diversion.recovery.iataCode

String

2-character airline IATA code e.g A

flightRecords[].arrival.diversion.original.iataCode

String

2-character airline IATA code e.g A

flightRecords[].flightStats.passengers.child

String

Total number of children

flightRecords[].flightStats.passengers.bookedTotal

String

Total number of booked passengers

flightRecords[].departure.checkinSlots[].externalName

String

Name used to identify the slot

flightRecords[].departure.carousel

String

Expected carousel(s) for baggage reclaim

flightRecords[].departure.airport.name

String

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

flightRecords[].departure.diversion.original

Object

Original flight

flightRecords[].arrival.diversion.recovery

Object

Recovery flight

flightRecords[].arrival.diversion.original

Object

Original flight

flightRecords[].departure.chute

String

Baggage chute details e.g CH-2

flightRecords[].flightIdentifier.marketingCarriers[]

Array

Marketing Carriers

flightRecords[].departure.scheduled

String

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

flightRecords[].flightStats.baggage.count

String

Total number of bags/pieces

flightRecords[].flightStats.passengers.bookedEconomy

String

Total number of booked economy class passengers

flightRecords[].flightIdentifier.marketingCarriers[].name

String

Name of airline e.g American Airlines

flightRecords[].departure.diversion

Object

Diversion

flightRecords[].arrival.diversion.recovery.scheduled

String

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

flightRecords[].arrival.diversion.original.scheduled

String

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

flightRecords[].arrival.diversion

Object

Diversion

flightRecords[].flightIdentifier.marketingCarriers[].iataCode

String

2-character airline IATA code e.g AA

flightRecords[].flightIdentifier.marketingCarriers[].flightNumber

String

Flight number e.g 1234

flightRecords[].departure.checkIn

String

Check-in desk details e.g CK-1

flightRecords[].departure.airport.cityText

String

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

flightRecords[].flightStats.baggage

Object

Baggage

flightRecords[].flightStats.passengers.bookedBusiness

String

Total number of booked business class passengers

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

String

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

flightRecords[].departure.events.TTOT

String

The local time at which the aircraft is targeted to leave the runway e.g 2020-01-22T12:00:00+03:00

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

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.events.targetTakeOffTime

String

Target Take Off Time

flightRecords[].flightIdentifier.operatingCarrier.flightNumber

String

Flight number e.g 1234

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

String

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

flightRecords[].departure.events.TOBT

String

The local time at which the aircraft is targeted to leave the gate e.g 2020-01-22T12:00:00+03:00

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

String

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

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

String

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

flightRecords[].arrival.events.targetOffBlockTime

String

Target Off Block Time

flightRecords[].flightIdentifier.operatingCarrier.name

String

Name of airline e.g American Airlines

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

String

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

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

String

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

flightRecords[].metadata.lastUpdateTime

String

UTC timestamp when last update update was applied to this flight

flightRecords[].departure.events.ETOT

String

The estimated local time at which the aircraft is expected to leave the runway e.g 2020-01-22T12:00:00+03:00

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

String

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

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

String

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

flightRecords[].arrival.events.estimatedTakeOffTime

String

Estimated Take Off Time

flightRecords[].flightIdentifier.operatingCarrier.iataCode

String

2-character airline IATA code e.g AA

flightRecords[].arrival.events.estimatedOffBlockTime

String

Estimated Off Block Time

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

String

4-character airport ICAO code e.g KJFK

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

String

4-character airport ICAO code e.g KJFK

flightRecords[].metadata.provider

String

Data source of the last update applied to this flight

flightRecords[].departure.events.EOBT

String

The estimated local time at which the aircraft is expected to leave the gate e.g 2020-01-22T12:00:00+03:00

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

String

4-character airport ICAO code e.g KJFK

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

String

4-character airport ICAO code e.g KJFK

flightRecords[].flightIdentifier.operatingCarrier.icaoCode

String

3-character airline ICAO code e.g AAL

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

String

3-character airport IATA code e.g JFK

flightRecords[].arrival.events.estimatedInBlockTime

String

Estimated In Block Time

flightRecords[].arrival.airport.iataCode

String

3-character airport IATA code e.g JFK

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

String

3-character airport IATA code e.g JFK

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

String

3-character airport IATA code e.g JFK

flightRecords[].metadata

Object

Metadata

flightRecords[].departure.events.EIBT

String

The estimated local time at which the aircraft is expected at the gate e.g 2020-01-22T12:00:00+03:00

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

String

3-character airport IATA code e.g JFK

flightRecords[].flightStats.passengers.actualTransit

String

Actual number of transit passengers

flightRecords[].flightIdentifier.aircraft.callSign

String

Call-sign for the aircraft type

flightRecords[].flightIdentifier

Object

Flight Identifier

flightRecords[].departure.events.ELDT

String

The estimated local time at which the aircraft is expected to land on the runway e.g 2020-01-22T12:00:00+03:00

flightRecords[].arrival.diversion.recovery.airport

Object

Airport

flightRecords[].arrival.diversion.original.airport

Object

Airport

flightRecords[].arrival.airport

Object

Airport

flightRecords[].departure.diversion.recovery.airport

Object

Airport

flightRecords[].departure.diversion.original.airport

Object

Airport

flightRecords[].duration

String

Flight duration in minutes e.g 60

flightRecords[].flightStats.passengers.actualTransfer

String

Actual number of transfer passengers

flightRecords[].flightIdentifier.aircraft.registration

String

Aircraft registration/tail number details e.g EIAA44W

flightRecords[].flightIdentifier.operatingCarrier

Object

Operating Carrier

flightRecords[].departure.diversion.original.name

String

Name of airline e.g American Airlines

flightRecords[].serviceType

String

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

flightRecords[].departure.events.ATOT

String

The actual local time at which the aircraft left the runway e.g 2020-01-22T12:00:00+03:00

flightRecords[].arrival.diversion.recovery.name

String

Name of airline e.g American Airlines

flightRecords[].arrival.diversion.original.name

String

Name of airline e.g American Airlines

flightRecords[].arrival.terminal

String

The flights departure/arrival terminal e.g T1

flightRecords[].arrival

Object

Arrival

flightRecords[].departure.diversion.recovery.name

String

Name of airline e.g American Airlines

flightRecords[].flightStats.passengers

Object

Passengers

flightRecords[].departure.diversion.recovery.flightNumber

String

Flight number e.g 1234

flightRecords[].departure.diversion.original.flightNumber

String

Flight number e.g 1234

flightRecords[].arrival.delayPrediction.message

String

A message related to the prediction

flightRecords[].departure.events.AOBT

String

The actual local time at which the aircraft left the gate e.g 2020-01-22T12:00:00+03:00

flightRecords[].arrival.diversion.recovery.flightNumber

String

Flight number e.g 1234

flightRecords[].arrival.statusText

String

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

flightRecords[].departure.delayPrediction.message

String

A message related to the prediction

flightRecords[].flightStats

Object

Flight Stats

flightRecords[]

Array

Flight Records

Curl request
$ curl 'https://historical.api.aero/historical/v2/flights/airport/MCT/airline/UL/direction/D?operationDate=2021-04-01' -i -X GET \
    -H 'Content-Type: application/json' \
    -H 'X-apiKey: Insert your API key here'
HTTP response
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 3330

{
  "flightRecords" : [ {
    "flightIdentifier" : {
      "operatingCarrier" : {
        "iataCode" : "UL",
        "flightNumber" : "1512",
        "name" : "SriLankan Airlines"
      },
      "aircraft" : {
        "iataCode" : "321",
        "icaoCode" : "A321",
        "model" : "A321",
        "registration" : "4RAND"
      }
    },
    "flightStats" : {
      "passengers" : {
        "bookedTotal" : "120",
        "adult" : "109",
        "child" : "2",
        "infant" : "2"
      },
      "baggage" : {
        "count" : "235",
        "load" : "3661",
        "cargo" : "0",
        "mail" : "0"
      }
    },
    "departure" : {
      "airport" : {
        "iataCode" : "CMB",
        "cityText" : "Colombo"
      },
      "scheduled" : "2021-04-01T12:25:00+04:00",
      "estimated" : "2021-04-01T14:43:00+05:30",
      "actual" : "2021-04-01T13:48:00+05:30",
      "status" : "DP",
      "statusText" : "Departed",
      "terminal" : "T1",
      "gate" : "C3",
      "stand" : "401R",
      "checkIn" : "F10",
      "chute" : "S1",
      "standSlots" : [ {
        "name" : "401R",
        "externalName" : "401R",
        "startTime" : "2021-04-01T11:06:00+04:00",
        "endTime" : "2021-04-01T12:18:00+04:00",
        "area" : "Sector 4C"
      } ],
      "checkinSlots" : [ {
        "name" : "F10",
        "externalName" : "F10",
        "startTime" : "2021-04-01T07:40:00+04:00",
        "endTime" : "2021-04-01T11:25:00+04:00",
        "area" : "Check-In F"
      }, {
        "name" : "F11",
        "externalName" : "F11",
        "startTime" : "2021-04-01T07:40:00+04:00",
        "endTime" : "2021-04-01T11:25:00+04:00",
        "area" : "Check-In F"
      }, {
        "name" : "F12",
        "externalName" : "F12",
        "startTime" : "2021-04-01T07:40:00+04:00",
        "endTime" : "2021-04-01T11:25:00+04:00",
        "area" : "Check-In F"
      }, {
        "name" : "F8",
        "externalName" : "F8",
        "startTime" : "2021-04-01T07:40:00+04:00",
        "endTime" : "2021-04-01T11:25:00+04:00",
        "area" : "Check-In F"
      }, {
        "name" : "F9",
        "externalName" : "F9",
        "startTime" : "2021-04-01T07:40:00+04:00",
        "endTime" : "2021-04-01T11:25:00+04:00",
        "area" : "Check-In F"
      } ],
      "gateSlots" : [ {
        "name" : "C3",
        "externalName" : "C3",
        "startTime" : "2021-04-01T11:18:00+04:00",
        "endTime" : "2021-04-01T12:18:00+04:00",
        "area" : "Pier C Contact"
      } ],
      "chuteSlots" : [ {
        "name" : "S1",
        "externalName" : "S1",
        "startTime" : "2021-04-01T09:25:00+04:00",
        "endTime" : "2021-04-01T11:25:00+04:00",
        "area" : "Chutes"
      } ],
      "route" : [ {
        "sequenceNumber" : 0
      } ],
      "customProperties" : [ {
        "key" : "S---_Status",
        "value" : "SCH"
      } ],
      "events" : {
        "AOBT" : "2021-04-01T12:18:00+04:00",
        "ATOT" : "2021-04-01T12:26:00+04:00",
        "EOBT" : "2021-04-01T13:13:00+04:00"
      },
      "delayPrediction" : {
        "minutes" : 65,
        "prediction" : "2021-04-01T13:30:00+04:00"
      }
    },
    "serviceType" : "J",
    "duration" : 255
  } ]
}

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

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

airportCode

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

direction

1-character direction indicator (A/D)

Request parameters
Parameter Description

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

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
Name Description

Content-Type

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

X-apiKey

Authorization header that contains the API key.

Response fields
Path Type Description

flightRecords[].departure.route[].icaoCode

String

4-character airport ICAO code

flightRecords[].departure.gateSlots[].externalName

String

Name used to identify the slot

flightRecords[].departure.delayPrediction.minutes

String

Calculated Delay in Minutes

flightRecords[].departure.diversion.recovery.icaoCode

String

3-character airline ICAO code e.g AAL

flightRecords[].departure.diversion.original.icaoCode

String

3-character airline ICAO code e.g AAL

flightRecords[].arrival.delayPrediction.minutes

String

Calculated Delay in Minutes

flightRecords[].arrival.diversion.recovery.icaoCode

String

3-character airline ICAO code e.g AAL

flightRecords[].arrival.standSlots[].externalName

String

Name used to identify the slot

flightRecords[].arrival.status

String

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

flightRecords[].departure.route[].iataCode

String

3-character airport IATA code

flightRecords[].arrival.actual

String

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

flightRecords[].departure.delayPrediction.prediction

String

Calculated Delay Prediction

flightRecords[].departure.diversion.recovery.iataCode

String

2-character airline IATA code e.g A

flightRecords[].departure.diversion.original.iataCode

String

2-character airline IATA code e.g A

flightRecords[].arrival.delayPrediction.prediction

String

Calculated Delay Prediction

flightRecords[].arrival.standSlots[].name

String

Name used to identify the slot internally

flightRecords[].departure.customProperties[]

Array

Custom Properties

flightRecords[].departure.gateSlots[].endTime

String

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

flightRecords[].departure.checkinSlots[].endTime

String

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

flightRecords[].arrival.standSlots[]

Array

Stand Slots

flightRecords[].arrival.estimated

String

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

flightRecords[].departure.delayPrediction

Object

Flight Delay Prediction. Available for Premium Users.

flightRecords[].departure.diversion.recovery

Object

Recovery flight

flightRecords[].arrival.carouselSlots[]

Array

Carousel Slots

flightRecords[].arrival.delayPrediction

Object

Flight Delay Prediction. Available for Premium Users.

flightRecords[].departure.customProperties[].key

String

Key value used to identify a custom property

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.gateSlots[].startTime

String

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

flightRecords[].arrival.checkinSlots[].area

String

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

flightRecords[].arrival.chute

String

Baggage chute details e.g CH-2

flightRecords[].arrival.scheduled

String

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

flightRecords[].departure.diversion.recovery.scheduled

String

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

flightRecords[].departure.diversion.original.scheduled

String

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

flightRecords[].arrival.gateSlots[].endTime

String

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

flightRecords[].arrival.checkinSlots[].endTime

String

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

flightRecords[].arrival.checkIn

String

Check-in desk details e.g CK-1

flightRecords[].arrival.airport.cityText

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[].arrival.gateSlots[].startTime

String

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

flightRecords[].arrival.checkinSlots[].startTime

String

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

flightRecords[].arrival.stand

String

Aircraft stand details e.g S12

flightRecords[].arrival.airport.city

String

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

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

String

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

flightRecords[].departure.route[]

Array

Route

flightRecords[].arrival.route[].icaoCode

String

4-character airport ICAO code

flightRecords[].arrival.gateSlots[].externalName

String

Name used to identify the slot

flightRecords[].arrival.checkinSlots[].externalName

String

Name used to identify the slot

flightRecords[].arrival.carousel

String

Expected carousel(s) for baggage reclaim

flightRecords[].arrival.airport.name

String

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

flightRecords[].arrival.route[].iataCode

String

3-character airport IATA code

flightRecords[].arrival.gateSlots[].name

String

Name used to identify the slot internally

flightRecords[].arrival.checkinSlots[].name

String

Name used to identify the slot internally

flightRecords[].arrival.gateRemarkText

String

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

flightRecords[].arrival.airport.icaoCode

String

4-character airport ICAO code e.g KJFK

flightRecords[].arrival.events.estimatedLandingTime

String

Estimated Landing Time

flightRecords[].arrival.route[]

Array

Route

flightRecords[].arrival.gateSlots[]

Array

Gate Slots

flightRecords[].arrival.checkinSlots[]

Array

Checkin Slots

flightRecords[].arrival.gateRemark

String

 

flightRecords[].departure.standSlots[].area

String

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

flightRecords[].departure.gate

String

The flights departure/arrival gate e.g C1

flightRecords[].departure.airport

Object

Airport

flightRecords[].departure.chuteSlots[].area

String

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

flightRecords[].departure.carouselSlots[].area

String

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

flightRecords[].arrival.events.actualTakeOffTime

String

Actual Take Off Time

flightRecords[].arrival.chuteSlots[].area

String

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

flightRecords[].arrival.carouselSlots[].area

String

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

flightRecords[].arrival.standSlots[].area

String

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

flightRecords[].arrival.gate

String

The flights departure/arrival gate e.g C1

flightRecords[].departure.carouselSlots[].endTime

String

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

flightRecords[].departure.standSlots[].endTime

String

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

flightRecords[].departure.terminal

String

The flights departure/arrival terminal e.g T1

flightRecords[].departure

Object

Departure

flightRecords[].departure.chuteSlots[].endTime

String

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

flightRecords[].arrival.events.actualOffBlockTime

String

Actual Off Block Time

flightRecords[].arrival.chuteSlots[].endTime

String

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

flightRecords[].arrival.carouselSlots[].endTime

String

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

flightRecords[].arrival.standSlots[].endTime

String

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

flightRecords[].departure.airport.icaoCode

String

4-character airport ICAO code e.g KJFK

flightRecords[].flightStats.passengers.adult

String

Total number of adults

flightRecords[].departure.gateSlots[].name

String

Name used to identify the slot internally

flightRecords[].departure.checkinSlots[].name

String

Name used to identify the slot internally

flightRecords[].departure.gateRemarkText

String

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

flightRecords[].arrival.standSlots[].startTime

String

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

flightRecords[].arrival.events.actualInBlockTime

String

Actual In Block Time

flightRecords[].arrival.chuteSlots[].startTime

String

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

flightRecords[].arrival.carouselSlots[].startTime

String

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

flightRecords[].departure.gateRemark

String

 

flightRecords[].departure.airport.iataCode

String

3-character airport IATA code e.g JFK

flightRecords[].flightStats.passengers.reducedMobility

String

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

flightRecords[].departure.gateSlots[]

Array

Gate Slots

flightRecords[].departure.checkinSlots[]

Array

Checkin Slots

flightRecords[].departure.carouselSlots[]

Array

Carousel Slots

flightRecords[].departure.standSlots[]

Array

Stand Slots

flightRecords[].arrival.carouselSlots[].externalName

String

Name used to identify the slot

flightRecords[].arrival.events.actualLandingTime

String

Actual Landing Time

flightRecords[].arrival.chuteSlots[].externalName

String

Name used to identify the slot

flightRecords[].departure.events

Object

Events

flightRecords[].departure.chuteSlots[].name

String

Name used to identify the slot internally

flightRecords[].departure.carouselSlots[].name

String

Name used to identify the slot internally

flightRecords[].departure.gateSlots[].area

String

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

flightRecords[].departure.checkinSlots[].area

String

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

flightRecords[].arrival.chuteSlots[].name

String

Name used to identify the slot internally

flightRecords[].arrival.carouselSlots[].name

String

Name used to identify the slot internally

flightRecords[].arrival.events

Object

Events

flightRecords[].departure.customProperties[].value

String

The value of a custom property

flightRecords[].departure.chuteSlots[]

Array

Chute Slots

flightRecords[].departure.status

String

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

flightRecords[].arrival.customProperties[].value

String

The value of a custom property

flightRecords[].arrival.chuteSlots[]

Array

Chute Slots

flightRecords[].departure.chuteSlots[].startTime

String

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

flightRecords[].departure.carouselSlots[].startTime

String

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

flightRecords[].departure.standSlots[].startTime

String

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

flightRecords[].departure.statusText

String

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

flightRecords[].departure.events.AIBT

String

The actual local time at which the aircraft arrived at the gate e.g 2020-01-22T12:00:00+03:00

flightRecords[].departure.standSlots[].name

String

Name used to identify the slot internally

flightRecords[].arrival.customProperties[].key

String

Key value used to identify a custom property

flightRecords[].arrival.gateSlots[].area

String

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

flightRecords[].departure.events.ALDT

String

The actual local time at which the aircraft landed on the runway e.g 2020-01-22T12:00:00+03:00

flightRecords[].departure.chuteSlots[].externalName

String

Name used to identify the slot

flightRecords[].departure.carouselSlots[].externalName

String

Name used to identify the slot

flightRecords[].departure.standSlots[].externalName

String

Name used to identify the slot

flightRecords[].arrival.customProperties[]

Array

Custom Properties

flightRecords[].departure.actual

String

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

flightRecords[].flightStats.baggage.totalWeight

String

Total weight of bags/pieces

flightRecords[].flightStats.passengers.actualFirst

String

Actual number of 1st class passengers

flightRecords[].flightIdentifier.aircraft.iataCode

String

IATA code for the aircraft

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[].departure.estimated

String

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

flightRecords[].flightStats.baggage.load

String

Load breakdown

flightRecords[].flightStats.passengers.actualTotal

String

Actual number of passengers

flightRecords[].flightIdentifier.aircraft

Object

Aircraft

flightRecords[].flightStats.baggage.mail

String

Total number of mail pieces

flightRecords[].flightStats.passengers.actualEconomy

String

Actual number of economy class passengers

flightRecords[].flightIdentifier.aircraft.model

String

Specific aircraft model details

flightRecords[].arrival.diversion.original.flightNumber

String

Flight number e.g 1234

flightRecords[].flightStats.baggage.cargo

String

Total number of cargo pieces

flightRecords[].flightStats.passengers.actualBusiness

String

Actual number of business class passengers

flightRecords[].flightIdentifier.aircraft.icaoCode

String

ICAO code for the aircraft

flightRecords[].arrival.diversion.original.icaoCode

String

3-character airline ICAO code e.g AAL

flightRecords[].flightIdentifier.marketingCarriers[].icaoCode

String

3-character airline ICAO code e.g AAL

flightRecords[].flightStats.passengers.bookedFirst

String

Total number of booked 1st class passengers

flightRecords[].departure.checkinSlots[].startTime

String

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

flightRecords[].departure.stand

String

Aircraft stand details e.g S12

flightRecords[].departure.airport.city

String

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

flightRecords[].flightStats.passengers.infant

String

Total number of infants

flightRecords[].arrival.diversion.recovery.iataCode

String

2-character airline IATA code e.g A

flightRecords[].arrival.diversion.original.iataCode

String

2-character airline IATA code e.g A

flightRecords[].flightStats.passengers.child

String

Total number of children

flightRecords[].flightStats.passengers.bookedTotal

String

Total number of booked passengers

flightRecords[].departure.checkinSlots[].externalName

String

Name used to identify the slot

flightRecords[].departure.carousel

String

Expected carousel(s) for baggage reclaim

flightRecords[].departure.airport.name

String

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

flightRecords[].departure.diversion.original

Object

Original flight

flightRecords[].arrival.diversion.recovery

Object

Recovery flight

flightRecords[].arrival.diversion.original

Object

Original flight

flightRecords[].departure.chute

String

Baggage chute details e.g CH-2

flightRecords[].flightIdentifier.marketingCarriers[]

Array

Marketing Carriers

flightRecords[].departure.scheduled

String

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

flightRecords[].flightStats.baggage.count

String

Total number of bags/pieces

flightRecords[].flightStats.passengers.bookedEconomy

String

Total number of booked economy class passengers

flightRecords[].flightIdentifier.marketingCarriers[].name

String

Name of airline e.g American Airlines

flightRecords[].departure.diversion

Object

Diversion

flightRecords[].arrival.diversion.recovery.scheduled

String

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

flightRecords[].arrival.diversion.original.scheduled

String

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

flightRecords[].arrival.diversion

Object

Diversion

flightRecords[].flightIdentifier.marketingCarriers[].iataCode

String

2-character airline IATA code e.g AA

flightRecords[].flightIdentifier.marketingCarriers[].flightNumber

String

Flight number e.g 1234

flightRecords[].departure.checkIn

String

Check-in desk details e.g CK-1

flightRecords[].departure.airport.cityText

String

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

flightRecords[].flightStats.baggage

Object

Baggage

flightRecords[].flightStats.passengers.bookedBusiness

String

Total number of booked business class passengers

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

String

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

flightRecords[].departure.events.TTOT

String

The local time at which the aircraft is targeted to leave the runway e.g 2020-01-22T12:00:00+03:00

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

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.events.targetTakeOffTime

String

Target Take Off Time

flightRecords[].flightIdentifier.operatingCarrier.flightNumber

String

Flight number e.g 1234

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

String

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

flightRecords[].departure.events.TOBT

String

The local time at which the aircraft is targeted to leave the gate e.g 2020-01-22T12:00:00+03:00

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

String

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

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

String

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

flightRecords[].arrival.events.targetOffBlockTime

String

Target Off Block Time

flightRecords[].flightIdentifier.operatingCarrier.name

String

Name of airline e.g American Airlines

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

String

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

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

String

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

flightRecords[].metadata.lastUpdateTime

String

UTC timestamp when last update update was applied to this flight

flightRecords[].departure.events.ETOT

String

The estimated local time at which the aircraft is expected to leave the runway e.g 2020-01-22T12:00:00+03:00

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

String

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

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

String

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

flightRecords[].arrival.events.estimatedTakeOffTime

String

Estimated Take Off Time

flightRecords[].flightIdentifier.operatingCarrier.iataCode

String

2-character airline IATA code e.g AA

flightRecords[].arrival.events.estimatedOffBlockTime

String

Estimated Off Block Time

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

String

4-character airport ICAO code e.g KJFK

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

String

4-character airport ICAO code e.g KJFK

flightRecords[].metadata.provider

String

Data source of the last update applied to this flight

flightRecords[].departure.events.EOBT

String

The estimated local time at which the aircraft is expected to leave the gate e.g 2020-01-22T12:00:00+03:00

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

String

4-character airport ICAO code e.g KJFK

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

String

4-character airport ICAO code e.g KJFK

flightRecords[].flightIdentifier.operatingCarrier.icaoCode

String

3-character airline ICAO code e.g AAL

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

String

3-character airport IATA code e.g JFK

flightRecords[].arrival.events.estimatedInBlockTime

String

Estimated In Block Time

flightRecords[].arrival.airport.iataCode

String

3-character airport IATA code e.g JFK

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

String

3-character airport IATA code e.g JFK

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

String

3-character airport IATA code e.g JFK

flightRecords[].metadata

Object

Metadata

flightRecords[].departure.events.EIBT

String

The estimated local time at which the aircraft is expected at the gate e.g 2020-01-22T12:00:00+03:00

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

String

3-character airport IATA code e.g JFK

flightRecords[].flightStats.passengers.actualTransit

String

Actual number of transit passengers

flightRecords[].flightIdentifier.aircraft.callSign

String

Call-sign for the aircraft type

flightRecords[].flightIdentifier

Object

Flight Identifier

flightRecords[].departure.events.ELDT

String

The estimated local time at which the aircraft is expected to land on the runway e.g 2020-01-22T12:00:00+03:00

flightRecords[].arrival.diversion.recovery.airport

Object

Airport

flightRecords[].arrival.diversion.original.airport

Object

Airport

flightRecords[].arrival.airport

Object

Airport

flightRecords[].departure.diversion.recovery.airport

Object

Airport

flightRecords[].departure.diversion.original.airport

Object

Airport

flightRecords[].duration

String

Flight duration in minutes e.g 60

flightRecords[].flightStats.passengers.actualTransfer

String

Actual number of transfer passengers

flightRecords[].flightIdentifier.aircraft.registration

String

Aircraft registration/tail number details e.g EIAA44W

flightRecords[].flightIdentifier.operatingCarrier

Object

Operating Carrier

flightRecords[].departure.diversion.original.name

String

Name of airline e.g American Airlines

flightRecords[].serviceType

String

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

flightRecords[].departure.events.ATOT

String

The actual local time at which the aircraft left the runway e.g 2020-01-22T12:00:00+03:00

flightRecords[].arrival.diversion.recovery.name

String

Name of airline e.g American Airlines

flightRecords[].arrival.diversion.original.name

String

Name of airline e.g American Airlines

flightRecords[].arrival.terminal

String

The flights departure/arrival terminal e.g T1

flightRecords[].arrival

Object

Arrival

flightRecords[].departure.diversion.recovery.name

String

Name of airline e.g American Airlines

flightRecords[].flightStats.passengers

Object

Passengers

flightRecords[].departure.diversion.recovery.flightNumber

String

Flight number e.g 1234

flightRecords[].departure.diversion.original.flightNumber

String

Flight number e.g 1234

flightRecords[].arrival.delayPrediction.message

String

A message related to the prediction

flightRecords[].departure.events.AOBT

String

The actual local time at which the aircraft left the gate e.g 2020-01-22T12:00:00+03:00

flightRecords[].arrival.diversion.recovery.flightNumber

String

Flight number e.g 1234

flightRecords[].arrival.statusText

String

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

flightRecords[].departure.delayPrediction.message

String

A message related to the prediction

flightRecords[].flightStats

Object

Flight Stats

flightRecords[]

Array

Flight Records

Curl request
$ curl 'https://historical.api.aero/historical/v2/flights/airport/MCT/direction/D?operationDate=2021-04-01' -i -X GET \
    -H 'Content-Type: application/json' \
    -H 'X-apiKey: Insert your API key here'
HTTP response
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 3330

{
  "flightRecords" : [ {
    "flightIdentifier" : {
      "operatingCarrier" : {
        "iataCode" : "UL",
        "flightNumber" : "1512",
        "name" : "SriLankan Airlines"
      },
      "aircraft" : {
        "iataCode" : "321",
        "icaoCode" : "A321",
        "model" : "A321",
        "registration" : "4RAND"
      }
    },
    "flightStats" : {
      "passengers" : {
        "bookedTotal" : "120",
        "adult" : "109",
        "child" : "2",
        "infant" : "2"
      },
      "baggage" : {
        "count" : "235",
        "load" : "3661",
        "cargo" : "0",
        "mail" : "0"
      }
    },
    "departure" : {
      "airport" : {
        "iataCode" : "CMB",
        "cityText" : "Colombo"
      },
      "scheduled" : "2021-04-01T12:25:00+04:00",
      "estimated" : "2021-04-01T14:43:00+05:30",
      "actual" : "2021-04-01T13:48:00+05:30",
      "status" : "DP",
      "statusText" : "Departed",
      "terminal" : "T1",
      "gate" : "C3",
      "stand" : "401R",
      "checkIn" : "F10",
      "chute" : "S1",
      "standSlots" : [ {
        "name" : "401R",
        "externalName" : "401R",
        "startTime" : "2021-04-01T11:06:00+04:00",
        "endTime" : "2021-04-01T12:18:00+04:00",
        "area" : "Sector 4C"
      } ],
      "checkinSlots" : [ {
        "name" : "F10",
        "externalName" : "F10",
        "startTime" : "2021-04-01T07:40:00+04:00",
        "endTime" : "2021-04-01T11:25:00+04:00",
        "area" : "Check-In F"
      }, {
        "name" : "F11",
        "externalName" : "F11",
        "startTime" : "2021-04-01T07:40:00+04:00",
        "endTime" : "2021-04-01T11:25:00+04:00",
        "area" : "Check-In F"
      }, {
        "name" : "F12",
        "externalName" : "F12",
        "startTime" : "2021-04-01T07:40:00+04:00",
        "endTime" : "2021-04-01T11:25:00+04:00",
        "area" : "Check-In F"
      }, {
        "name" : "F8",
        "externalName" : "F8",
        "startTime" : "2021-04-01T07:40:00+04:00",
        "endTime" : "2021-04-01T11:25:00+04:00",
        "area" : "Check-In F"
      }, {
        "name" : "F9",
        "externalName" : "F9",
        "startTime" : "2021-04-01T07:40:00+04:00",
        "endTime" : "2021-04-01T11:25:00+04:00",
        "area" : "Check-In F"
      } ],
      "gateSlots" : [ {
        "name" : "C3",
        "externalName" : "C3",
        "startTime" : "2021-04-01T11:18:00+04:00",
        "endTime" : "2021-04-01T12:18:00+04:00",
        "area" : "Pier C Contact"
      } ],
      "chuteSlots" : [ {
        "name" : "S1",
        "externalName" : "S1",
        "startTime" : "2021-04-01T09:25:00+04:00",
        "endTime" : "2021-04-01T11:25:00+04:00",
        "area" : "Chutes"
      } ],
      "route" : [ {
        "sequenceNumber" : 0
      } ],
      "customProperties" : [ {
        "key" : "S---_Status",
        "value" : "SCH"
      } ],
      "events" : {
        "AOBT" : "2021-04-01T12:18:00+04:00",
        "ATOT" : "2021-04-01T12:26:00+04:00",
        "EOBT" : "2021-04-01T13:13:00+04:00"
      },
      "delayPrediction" : {
        "minutes" : 65,
        "prediction" : "2021-04-01T13:30:00+04:00"
      }
    },
    "serviceType" : "J",
    "duration" : 255
  } ]
}

3.2.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).
The date range defined by the 'from' and 'to' query parameters may not exceed 60 minutes.
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
/v2/flights/updates/airport/{airportCode}/airline/{airlineCode}/flightNumber/{flightNumber}
Parameter Description

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

Request parameters
Parameter Description

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

groupMarketingCarriers

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

verbose

Show additional information such as version

showCargo

Include cargo flights. Default value is false

direction

1-character direction indicator (A/D)

Request headers
Name Description

Content-Type

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

X-apiKey

Authorization header that contains the API key.

Response fields
Path Type Description

flightRecords[].flightIdentifier.operatingCarrier.icaoCode

String

3-character airline ICAO code e.g AAL

flightRecords[].flightIdentifier.aircraft.callSign

String

Call-sign for the aircraft type

flightRecords[].arrival.scheduled

String

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

flightRecords[].flightIdentifier.operatingCarrier.iataCode

String

2-character airline IATA code e.g A

flightRecords[].departure

Object

Departure

flightRecords[].flightIdentifier.operatingCarrier

Object

Operating Carrier

flightRecords[].flightIdentifier.aircraft.model

String

Specific aircraft model details

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

String

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

flightRecords[].duration

String

Flight duration in minutes e.g 60

flightRecords[].flightIdentifier

Object

Flight Identifier

flightRecords[].flightIdentifier.aircraft.registration

String

Aircraft registration/tail number details e.g EIAA44W

flightRecords[].arrival

Object

Arrival

flightRecords[].flightIdentifier.marketingCarriers[].iataCode

String

2-character airline IATA code e.g AA

flightRecords[].flightIdentifier.marketingCarriers[]

Array

Marketing Carriers

flightRecords[].flightIdentifier.operatingCarrier.name

String

Name of airline e.g American Airlines

flightRecords[].departure.scheduled

String

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

flightRecords[].flightIdentifier.operatingCarrier.flightNumber

String

Flight number e.g 1234

flightRecords[].departure.updates[]

Array

Updates

flightRecords[].arrival.updates[].previous

String

Previous field value

flightRecords[].arrival.updates[].current

String

Current field value

flightRecords[].flightIdentifier.marketingCarriers[].flightNumber

String

Flight number e.g 1234

flightRecords[].departure.updates[].updatedField

Object

Payload field which was updated

flightRecords[].arrival.updates[]

Array

Updates

flightRecords[].departure.version

Number

FLIFO internal version number

flightRecords[].arrival.updates[].updatedField

Object

Payload field which was updated

flightRecords[]

Array

Flight Records

flightRecords[].flightIdentifier.aircraft.iataCode

String

IATA code for the aircraft

flightRecords[].departure.updates[].received

String

UTC timestamp when update was received

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

String

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

flightRecords[].flightIdentifier.aircraft.icaoCode

String

ICAO code for the aircraft

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

String

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

flightRecords[].serviceType

String

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

flightRecords[].departure.updates[].previous

String

Previous field value

flightRecords[].arrival.updates[].received

String

UTC timestamp when update was received

flightRecords[].flightIdentifier.marketingCarriers[].name

String

Name of airline e.g American Airlines

flightRecords[].flightIdentifier.aircraft

Object

Aircraft

flightRecords[].departure.updates[].current

String

Current field value

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

String

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

flightRecords[].metadata.provider

String

Data source of this update

flightRecords[].arrival.version

Number

FLIFO internal version number

flightRecords[].metadata.lastUpdateTime

String

UTC timestamp when update was applied

flightRecords[].metadata

Object

Metadata

flightRecords[].flightIdentifier.marketingCarriers[].icaoCode

String

3-character airline ICAO code e.g AAL

Curl request
$ curl 'https://historical.api.aero/historical/v2/flights/updates/airport/MCT/airline/UL/flightNumber/1512?from=2021-04-01T03:00:00.000Z&to=2021-04-01T04:00:00.000Z' -i -X GET \
    -H 'Content-Type: application/json' \
    -H 'X-apiKey: Insert your API key here'
HTTP response
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 5521

{
  "flightRecords" : [ {
    "flightIdentifier" : {
      "operatingCarrier" : {
        "iataCode" : "UL",
        "icaoCode" : "ALK",
        "flightNumber" : "1512",
        "name" : "SriLankan Airlines"
      },
      "marketingCarriers" : [ {
        "iataCode" : "UL",
        "icaoCode" : "ALK",
        "flightNumber" : "512",
        "name" : "SriLankan Airlines"
      } ]
    },
    "departure" : {
      "scheduled" : "2021-04-01T08:25:00+00:00",
      "version" : 39,
      "updates" : [ {
        "updatedField" : "CHECK_IN_SLOT",
        "previous" : "[{\"name\":\"F9\",\"externalName\":\"F9\",\"startTime\":\"2021-04-01T08:25:00+04:00\",\"endTime\":\"2021-04-01T11:25:00+04:00\",\"area\":\"Check-In F\"},{\"name\":\"F10\",\"externalName\":\"F10\",\"startTime\":\"2021-04-01T08:25:00+04:00\",\"endTime\":\"2021-04-01T11:25:00+04:00\",\"area\":\"Check-In F\"},{\"name\":\"F11\",\"externalName\":\"F11\",\"startTime\":\"2021-04-01T08:25:00+04:00\",\"endTime\":\"2021-04-01T11:25:00+04:00\",\"area\":\"Check-In F\"},{\"name\":\"F12\",\"externalName\":\"F12\",\"startTime\":\"2021-04-01T08:25:00+04:00\",\"endTime\":\"2021-04-01T11:25:00+04:00\",\"area\":\"Check-In F\"},{\"name\":\"F8\",\"externalName\":\"F8\",\"startTime\":\"2021-04-01T08:25:00+04:00\",\"endTime\":\"2021-04-01T11:25:00+04:00\",\"area\":\"Check-In F\"}]",
        "current" : "[{\"name\":\"F9\",\"externalName\":\"F9\",\"startTime\":\"2021-04-01T07:40:00+04:00\",\"endTime\":\"2021-04-01T11:25:00+04:00\",\"area\":\"Check-In F\"},{\"name\":\"F10\",\"externalName\":\"F10\",\"startTime\":\"2021-04-01T07:40:00+04:00\",\"endTime\":\"2021-04-01T11:25:00+04:00\",\"area\":\"Check-In F\"},{\"name\":\"F11\",\"externalName\":\"F11\",\"startTime\":\"2021-04-01T07:40:00+04:00\",\"endTime\":\"2021-04-01T11:25:00+04:00\",\"area\":\"Check-In F\"},{\"name\":\"F12\",\"externalName\":\"F12\",\"startTime\":\"2021-04-01T07:40:00+04:00\",\"endTime\":\"2021-04-01T11:25:00+04:00\",\"area\":\"Check-In F\"},{\"name\":\"F8\",\"externalName\":\"F8\",\"startTime\":\"2021-04-01T07:40:00+04:00\",\"endTime\":\"2021-04-01T11:25:00+04:00\",\"area\":\"Check-In F\"}]",
        "received" : "2021-04-01T03:17:35.662Z"
      }, {
        "updatedField" : "STAND_SLOT",
        "previous" : "[{\"name\":\"401R\",\"externalName\":\"401R\",\"startTime\":\"2021-04-01T11:15:00+04:00\",\"endTime\":\"2021-04-01T12:25:00+04:00\",\"area\":\"Sector 4C\"}]",
        "current" : "[{\"name\":\"401R\",\"externalName\":\"401R\",\"startTime\":\"2021-04-01T11:19:00+04:00\",\"endTime\":\"2021-04-01T12:25:00+04:00\",\"area\":\"Sector 4C\"}]",
        "received" : "2021-04-01T04:34:28.747Z"
      }, {
        "updatedField" : "STAND_SLOT",
        "previous" : "[{\"name\":\"401R\",\"externalName\":\"401R\",\"startTime\":\"2021-04-01T11:19:00+04:00\",\"endTime\":\"2021-04-01T12:25:00+04:00\",\"area\":\"Sector 4C\"}]",
        "current" : "[{\"name\":\"401R\",\"externalName\":\"401R\",\"startTime\":\"2021-04-01T11:18:00+04:00\",\"endTime\":\"2021-04-01T12:25:00+04:00\",\"area\":\"Sector 4C\"}]",
        "received" : "2021-04-01T05:10:43.956Z"
      }, {
        "updatedField" : "STAND_SLOT",
        "previous" : "[{\"name\":\"401R\",\"externalName\":\"401R\",\"startTime\":\"2021-04-01T11:18:00+04:00\",\"endTime\":\"2021-04-01T12:25:00+04:00\",\"area\":\"Sector 4C\"}]",
        "current" : "[{\"name\":\"401R\",\"externalName\":\"401R\",\"startTime\":\"2021-04-01T11:06:00+04:00\",\"endTime\":\"2021-04-01T12:25:00+04:00\",\"area\":\"Sector 4C\"}]",
        "received" : "2021-04-01T07:06:13.922Z"
      }, {
        "updatedField" : "STATUS",
        "previous" : "SC",
        "current" : "FC",
        "received" : "2021-04-01T07:52:30.967Z"
      }, {
        "updatedField" : "STATUS",
        "previous" : "FC",
        "current" : "GC",
        "received" : "2021-04-01T08:13:56.299Z"
      }, {
        "updatedField" : "ESTIMATED",
        "current" : "2021-04-01T13:58:00+05:30",
        "received" : "2021-04-01T08:22:41.375Z"
      }, {
        "updatedField" : "GATE_SLOT",
        "previous" : "[{\"name\":\"C3\",\"externalName\":\"C3\",\"startTime\":\"2021-04-01T11:25:00+04:00\",\"endTime\":\"2021-04-01T12:25:00+04:00\",\"area\":\"Pier C Contact\"}]",
        "current" : "[{\"name\":\"C3\",\"externalName\":\"C3\",\"startTime\":\"2021-04-01T11:28:00+04:00\",\"endTime\":\"2021-04-01T12:28:00+04:00\",\"area\":\"Pier C Contact\"}]",
        "received" : "2021-04-01T08:22:41.375Z"
      }, {
        "updatedField" : "EVENTS",
        "previous" : "{}",
        "current" : "{\"EOBT\":\"2021-04-01T12:28:00+04:00\"}",
        "received" : "2021-04-01T08:22:41.375Z"
      }, {
        "updatedField" : "STAND_SLOT",
        "previous" : "[{\"name\":\"401R\",\"externalName\":\"401R\",\"startTime\":\"2021-04-01T11:06:00+04:00\",\"endTime\":\"2021-04-01T12:25:00+04:00\",\"area\":\"Sector 4C\"}]",
        "current" : "[{\"name\":\"401R\",\"externalName\":\"401R\",\"startTime\":\"2021-04-01T11:06:00+04:00\",\"endTime\":\"2021-04-01T12:28:00+04:00\",\"area\":\"Sector 4C\"}]",
        "received" : "2021-04-01T08:22:41.376Z"
      }, {
        "updatedField" : "DELAY_PREDICTION",
        "previous" : "{\"minutes\":55,\"prediction\":\"2021-04-01T13:20:00+04:00\"}",
        "current" : "{\"minutes\":65,\"prediction\":\"2021-04-01T13:30:00+04:00\"}",
        "received" : "2021-04-01T08:25:12.156Z"
      } ]
    },
    "arrival" : {
      "version" : 39
    }
  } ]
}

3.2.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.
The date range defined by the 'from' and 'to' query parameters may not exceed 60 minutes.
Payload elements are filtered based on permissions associated with the 'X-apiKey' used in the request.

Path parameters
/v2/flights/updates/airport/{airportCode}/airline/{airlineCode}
Parameter Description

airportCode

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

airlineCode

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

Request parameters
Parameter Description

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

groupMarketingCarriers

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

verbose

Show additional information such as version

showCargo

Include cargo flights. Default value is false

direction

1-character direction indicator (A/D)

view

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

Request headers
Name Description

Content-Type

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

X-apiKey

Authorization header that contains the API key.

Response fields
Path Type Description

flightRecords[].flightIdentifier.operatingCarrier.icaoCode

String

3-character airline ICAO code e.g AAL

flightRecords[].flightIdentifier.aircraft.callSign

String

Call-sign for the aircraft type

flightRecords[].arrival.scheduled

String

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

flightRecords[].flightIdentifier.operatingCarrier.iataCode

String

2-character airline IATA code e.g A

flightRecords[].departure

Object

Departure

flightRecords[].flightIdentifier.operatingCarrier

Object

Operating Carrier

flightRecords[].flightIdentifier.aircraft.model

String

Specific aircraft model details

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

String

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

flightRecords[].duration

String

Flight duration in minutes e.g 60

flightRecords[].flightIdentifier

Object

Flight Identifier

flightRecords[].flightIdentifier.aircraft.registration

String

Aircraft registration/tail number details e.g EIAA44W

flightRecords[].arrival

Object

Arrival

flightRecords[].flightIdentifier.marketingCarriers[].iataCode

String

2-character airline IATA code e.g AA

flightRecords[].flightIdentifier.marketingCarriers[]

Array

Marketing Carriers

flightRecords[].flightIdentifier.operatingCarrier.name

String

Name of airline e.g American Airlines

flightRecords[].departure.scheduled

String

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

flightRecords[].flightIdentifier.operatingCarrier.flightNumber

String

Flight number e.g 1234

flightRecords[].departure.updates[]

Array

Updates

flightRecords[].arrival.updates[].previous

String

Previous field value

flightRecords[].arrival.updates[].current

String

Current field value

flightRecords[].flightIdentifier.marketingCarriers[].flightNumber

String

Flight number e.g 1234

flightRecords[].departure.updates[].updatedField

Object

Payload field which was updated

flightRecords[].arrival.updates[]

Array

Updates

flightRecords[].departure.version

Number

FLIFO internal version number

flightRecords[].arrival.updates[].updatedField

Object

Payload field which was updated

flightRecords[]

Array

Flight Records

flightRecords[].flightIdentifier.aircraft.iataCode

String

IATA code for the aircraft

flightRecords[].departure.updates[].received

String

UTC timestamp when update was received

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

String

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

flightRecords[].flightIdentifier.aircraft.icaoCode

String

ICAO code for the aircraft

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

String

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

flightRecords[].serviceType

String

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

flightRecords[].departure.updates[].previous

String

Previous field value

flightRecords[].arrival.updates[].received

String

UTC timestamp when update was received

flightRecords[].flightIdentifier.marketingCarriers[].name

String

Name of airline e.g American Airlines

flightRecords[].flightIdentifier.aircraft

Object

Aircraft

flightRecords[].departure.updates[].current

String

Current field value

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

String

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

flightRecords[].metadata.provider

String

Data source of this update

flightRecords[].arrival.version

Number

FLIFO internal version number

flightRecords[].metadata.lastUpdateTime

String

UTC timestamp when update was applied

flightRecords[].metadata

Object

Metadata

flightRecords[].flightIdentifier.marketingCarriers[].icaoCode

String

3-character airline ICAO code e.g AAL

Curl request
$ curl 'https://historical.api.aero/historical/v2/flights/updates/airport/MCT/airline/UL?from=2021-04-01T03:00:00.000Z&to=2021-04-01T04:00:00.000Z' -i -X GET \
    -H 'Content-Type: application/json' \
    -H 'X-apiKey: Insert your API key here'
HTTP response
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 5521

{
  "flightRecords" : [ {
    "flightIdentifier" : {
      "operatingCarrier" : {
        "iataCode" : "UL",
        "icaoCode" : "ALK",
        "flightNumber" : "1512",
        "name" : "SriLankan Airlines"
      },
      "marketingCarriers" : [ {
        "iataCode" : "UL",
        "icaoCode" : "ALK",
        "flightNumber" : "512",
        "name" : "SriLankan Airlines"
      } ]
    },
    "departure" : {
      "scheduled" : "2021-04-01T08:25:00+00:00",
      "version" : 39,
      "updates" : [ {
        "updatedField" : "CHECK_IN_SLOT",
        "previous" : "[{\"name\":\"F9\",\"externalName\":\"F9\",\"startTime\":\"2021-04-01T08:25:00+04:00\",\"endTime\":\"2021-04-01T11:25:00+04:00\",\"area\":\"Check-In F\"},{\"name\":\"F10\",\"externalName\":\"F10\",\"startTime\":\"2021-04-01T08:25:00+04:00\",\"endTime\":\"2021-04-01T11:25:00+04:00\",\"area\":\"Check-In F\"},{\"name\":\"F11\",\"externalName\":\"F11\",\"startTime\":\"2021-04-01T08:25:00+04:00\",\"endTime\":\"2021-04-01T11:25:00+04:00\",\"area\":\"Check-In F\"},{\"name\":\"F12\",\"externalName\":\"F12\",\"startTime\":\"2021-04-01T08:25:00+04:00\",\"endTime\":\"2021-04-01T11:25:00+04:00\",\"area\":\"Check-In F\"},{\"name\":\"F8\",\"externalName\":\"F8\",\"startTime\":\"2021-04-01T08:25:00+04:00\",\"endTime\":\"2021-04-01T11:25:00+04:00\",\"area\":\"Check-In F\"}]",
        "current" : "[{\"name\":\"F9\",\"externalName\":\"F9\",\"startTime\":\"2021-04-01T07:40:00+04:00\",\"endTime\":\"2021-04-01T11:25:00+04:00\",\"area\":\"Check-In F\"},{\"name\":\"F10\",\"externalName\":\"F10\",\"startTime\":\"2021-04-01T07:40:00+04:00\",\"endTime\":\"2021-04-01T11:25:00+04:00\",\"area\":\"Check-In F\"},{\"name\":\"F11\",\"externalName\":\"F11\",\"startTime\":\"2021-04-01T07:40:00+04:00\",\"endTime\":\"2021-04-01T11:25:00+04:00\",\"area\":\"Check-In F\"},{\"name\":\"F12\",\"externalName\":\"F12\",\"startTime\":\"2021-04-01T07:40:00+04:00\",\"endTime\":\"2021-04-01T11:25:00+04:00\",\"area\":\"Check-In F\"},{\"name\":\"F8\",\"externalName\":\"F8\",\"startTime\":\"2021-04-01T07:40:00+04:00\",\"endTime\":\"2021-04-01T11:25:00+04:00\",\"area\":\"Check-In F\"}]",
        "received" : "2021-04-01T03:17:35.662Z"
      }, {
        "updatedField" : "STAND_SLOT",
        "previous" : "[{\"name\":\"401R\",\"externalName\":\"401R\",\"startTime\":\"2021-04-01T11:15:00+04:00\",\"endTime\":\"2021-04-01T12:25:00+04:00\",\"area\":\"Sector 4C\"}]",
        "current" : "[{\"name\":\"401R\",\"externalName\":\"401R\",\"startTime\":\"2021-04-01T11:19:00+04:00\",\"endTime\":\"2021-04-01T12:25:00+04:00\",\"area\":\"Sector 4C\"}]",
        "received" : "2021-04-01T04:34:28.747Z"
      }, {
        "updatedField" : "STAND_SLOT",
        "previous" : "[{\"name\":\"401R\",\"externalName\":\"401R\",\"startTime\":\"2021-04-01T11:19:00+04:00\",\"endTime\":\"2021-04-01T12:25:00+04:00\",\"area\":\"Sector 4C\"}]",
        "current" : "[{\"name\":\"401R\",\"externalName\":\"401R\",\"startTime\":\"2021-04-01T11:18:00+04:00\",\"endTime\":\"2021-04-01T12:25:00+04:00\",\"area\":\"Sector 4C\"}]",
        "received" : "2021-04-01T05:10:43.956Z"
      }, {
        "updatedField" : "STAND_SLOT",
        "previous" : "[{\"name\":\"401R\",\"externalName\":\"401R\",\"startTime\":\"2021-04-01T11:18:00+04:00\",\"endTime\":\"2021-04-01T12:25:00+04:00\",\"area\":\"Sector 4C\"}]",
        "current" : "[{\"name\":\"401R\",\"externalName\":\"401R\",\"startTime\":\"2021-04-01T11:06:00+04:00\",\"endTime\":\"2021-04-01T12:25:00+04:00\",\"area\":\"Sector 4C\"}]",
        "received" : "2021-04-01T07:06:13.922Z"
      }, {
        "updatedField" : "STATUS",
        "previous" : "SC",
        "current" : "FC",
        "received" : "2021-04-01T07:52:30.967Z"
      }, {
        "updatedField" : "STATUS",
        "previous" : "FC",
        "current" : "GC",
        "received" : "2021-04-01T08:13:56.299Z"
      }, {
        "updatedField" : "ESTIMATED",
        "current" : "2021-04-01T13:58:00+05:30",
        "received" : "2021-04-01T08:22:41.375Z"
      }, {
        "updatedField" : "GATE_SLOT",
        "previous" : "[{\"name\":\"C3\",\"externalName\":\"C3\",\"startTime\":\"2021-04-01T11:25:00+04:00\",\"endTime\":\"2021-04-01T12:25:00+04:00\",\"area\":\"Pier C Contact\"}]",
        "current" : "[{\"name\":\"C3\",\"externalName\":\"C3\",\"startTime\":\"2021-04-01T11:28:00+04:00\",\"endTime\":\"2021-04-01T12:28:00+04:00\",\"area\":\"Pier C Contact\"}]",
        "received" : "2021-04-01T08:22:41.375Z"
      }, {
        "updatedField" : "EVENTS",
        "previous" : "{}",
        "current" : "{\"EOBT\":\"2021-04-01T12:28:00+04:00\"}",
        "received" : "2021-04-01T08:22:41.375Z"
      }, {
        "updatedField" : "STAND_SLOT",
        "previous" : "[{\"name\":\"401R\",\"externalName\":\"401R\",\"startTime\":\"2021-04-01T11:06:00+04:00\",\"endTime\":\"2021-04-01T12:25:00+04:00\",\"area\":\"Sector 4C\"}]",
        "current" : "[{\"name\":\"401R\",\"externalName\":\"401R\",\"startTime\":\"2021-04-01T11:06:00+04:00\",\"endTime\":\"2021-04-01T12:28:00+04:00\",\"area\":\"Sector 4C\"}]",
        "received" : "2021-04-01T08:22:41.376Z"
      }, {
        "updatedField" : "DELAY_PREDICTION",
        "previous" : "{\"minutes\":55,\"prediction\":\"2021-04-01T13:20:00+04:00\"}",
        "current" : "{\"minutes\":65,\"prediction\":\"2021-04-01T13:30:00+04:00\"}",
        "received" : "2021-04-01T08:25:12.156Z"
      } ]
    },
    "arrival" : {
      "version" : 39
    }
  } ]
}

3.2.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.
The date range defined by the 'from' and 'to' query parameters may not exceed 60 minutes.
Payload elements are filtered based on permissions associated with the 'X-apiKey' used in the request.

Path parameters
/v2/flights/updates/airport/{airportCode}
Parameter Description

airportCode

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

Request parameters
Parameter Description

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

groupMarketingCarriers

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

verbose

Show additional information such as version

showCargo

Include cargo flights. Default value is false

direction

1-character direction indicator (A/D)

view

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

Request headers
Name Description

Content-Type

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

X-apiKey

Authorization header that contains the API key.

Response fields
Path Type Description

flightRecords[].flightIdentifier.operatingCarrier.icaoCode

String

3-character airline ICAO code e.g AAL

flightRecords[].flightIdentifier.aircraft.callSign

String

Call-sign for the aircraft type

flightRecords[].arrival.scheduled

String

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

flightRecords[].flightIdentifier.operatingCarrier.iataCode

String

2-character airline IATA code e.g A

flightRecords[].departure

Object

Departure

flightRecords[].flightIdentifier.operatingCarrier

Object

Operating Carrier

flightRecords[].flightIdentifier.aircraft.model

String

Specific aircraft model details

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

String

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

flightRecords[].duration

String

Flight duration in minutes e.g 60

flightRecords[].flightIdentifier

Object

Flight Identifier

flightRecords[].flightIdentifier.aircraft.registration

String

Aircraft registration/tail number details e.g EIAA44W

flightRecords[].arrival

Object

Arrival

flightRecords[].flightIdentifier.marketingCarriers[].iataCode

String

2-character airline IATA code e.g AA

flightRecords[].flightIdentifier.marketingCarriers[]

Array

Marketing Carriers

flightRecords[].flightIdentifier.operatingCarrier.name

String

Name of airline e.g American Airlines

flightRecords[].departure.scheduled

String

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

flightRecords[].flightIdentifier.operatingCarrier.flightNumber

String

Flight number e.g 1234

flightRecords[].departure.updates[]

Array

Updates

flightRecords[].arrival.updates[].previous

String

Previous field value

flightRecords[].arrival.updates[].current

String

Current field value

flightRecords[].flightIdentifier.marketingCarriers[].flightNumber

String

Flight number e.g 1234

flightRecords[].departure.updates[].updatedField

Object

Payload field which was updated

flightRecords[].arrival.updates[]

Array

Updates

flightRecords[].departure.version

Number

FLIFO internal version number

flightRecords[].arrival.updates[].updatedField

Object

Payload field which was updated

flightRecords[]

Array

Flight Records

flightRecords[].flightIdentifier.aircraft.iataCode

String

IATA code for the aircraft

flightRecords[].departure.updates[].received

String

UTC timestamp when update was received

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

String

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

flightRecords[].flightIdentifier.aircraft.icaoCode

String

ICAO code for the aircraft

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

String

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

flightRecords[].serviceType

String

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

flightRecords[].departure.updates[].previous

String

Previous field value

flightRecords[].arrival.updates[].received

String

UTC timestamp when update was received

flightRecords[].flightIdentifier.marketingCarriers[].name

String

Name of airline e.g American Airlines

flightRecords[].flightIdentifier.aircraft

Object

Aircraft

flightRecords[].departure.updates[].current

String

Current field value

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

String

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

flightRecords[].metadata.provider

String

Data source of this update

flightRecords[].arrival.version

Number

FLIFO internal version number

flightRecords[].metadata.lastUpdateTime

String

UTC timestamp when update was applied

flightRecords[].metadata

Object

Metadata

flightRecords[].flightIdentifier.marketingCarriers[].icaoCode

String

3-character airline ICAO code e.g AAL

Curl request
$ curl 'https://historical.api.aero/historical/v2/flights/updates/airport/MCT?from=2021-04-01T03:00:00.000Z&to=2021-04-01T04:00:00.000Z' -i -X GET \
    -H 'Content-Type: application/json' \
    -H 'X-apiKey: Insert your API key here'
HTTP response
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 5521

{
  "flightRecords" : [ {
    "flightIdentifier" : {
      "operatingCarrier" : {
        "iataCode" : "UL",
        "icaoCode" : "ALK",
        "flightNumber" : "1512",
        "name" : "SriLankan Airlines"
      },
      "marketingCarriers" : [ {
        "iataCode" : "UL",
        "icaoCode" : "ALK",
        "flightNumber" : "512",
        "name" : "SriLankan Airlines"
      } ]
    },
    "departure" : {
      "scheduled" : "2021-04-01T08:25:00+00:00",
      "version" : 39,
      "updates" : [ {
        "updatedField" : "CHECK_IN_SLOT",
        "previous" : "[{\"name\":\"F9\",\"externalName\":\"F9\",\"startTime\":\"2021-04-01T08:25:00+04:00\",\"endTime\":\"2021-04-01T11:25:00+04:00\",\"area\":\"Check-In F\"},{\"name\":\"F10\",\"externalName\":\"F10\",\"startTime\":\"2021-04-01T08:25:00+04:00\",\"endTime\":\"2021-04-01T11:25:00+04:00\",\"area\":\"Check-In F\"},{\"name\":\"F11\",\"externalName\":\"F11\",\"startTime\":\"2021-04-01T08:25:00+04:00\",\"endTime\":\"2021-04-01T11:25:00+04:00\",\"area\":\"Check-In F\"},{\"name\":\"F12\",\"externalName\":\"F12\",\"startTime\":\"2021-04-01T08:25:00+04:00\",\"endTime\":\"2021-04-01T11:25:00+04:00\",\"area\":\"Check-In F\"},{\"name\":\"F8\",\"externalName\":\"F8\",\"startTime\":\"2021-04-01T08:25:00+04:00\",\"endTime\":\"2021-04-01T11:25:00+04:00\",\"area\":\"Check-In F\"}]",
        "current" : "[{\"name\":\"F9\",\"externalName\":\"F9\",\"startTime\":\"2021-04-01T07:40:00+04:00\",\"endTime\":\"2021-04-01T11:25:00+04:00\",\"area\":\"Check-In F\"},{\"name\":\"F10\",\"externalName\":\"F10\",\"startTime\":\"2021-04-01T07:40:00+04:00\",\"endTime\":\"2021-04-01T11:25:00+04:00\",\"area\":\"Check-In F\"},{\"name\":\"F11\",\"externalName\":\"F11\",\"startTime\":\"2021-04-01T07:40:00+04:00\",\"endTime\":\"2021-04-01T11:25:00+04:00\",\"area\":\"Check-In F\"},{\"name\":\"F12\",\"externalName\":\"F12\",\"startTime\":\"2021-04-01T07:40:00+04:00\",\"endTime\":\"2021-04-01T11:25:00+04:00\",\"area\":\"Check-In F\"},{\"name\":\"F8\",\"externalName\":\"F8\",\"startTime\":\"2021-04-01T07:40:00+04:00\",\"endTime\":\"2021-04-01T11:25:00+04:00\",\"area\":\"Check-In F\"}]",
        "received" : "2021-04-01T03:17:35.662Z"
      }, {
        "updatedField" : "STAND_SLOT",
        "previous" : "[{\"name\":\"401R\",\"externalName\":\"401R\",\"startTime\":\"2021-04-01T11:15:00+04:00\",\"endTime\":\"2021-04-01T12:25:00+04:00\",\"area\":\"Sector 4C\"}]",
        "current" : "[{\"name\":\"401R\",\"externalName\":\"401R\",\"startTime\":\"2021-04-01T11:19:00+04:00\",\"endTime\":\"2021-04-01T12:25:00+04:00\",\"area\":\"Sector 4C\"}]",
        "received" : "2021-04-01T04:34:28.747Z"
      }, {
        "updatedField" : "STAND_SLOT",
        "previous" : "[{\"name\":\"401R\",\"externalName\":\"401R\",\"startTime\":\"2021-04-01T11:19:00+04:00\",\"endTime\":\"2021-04-01T12:25:00+04:00\",\"area\":\"Sector 4C\"}]",
        "current" : "[{\"name\":\"401R\",\"externalName\":\"401R\",\"startTime\":\"2021-04-01T11:18:00+04:00\",\"endTime\":\"2021-04-01T12:25:00+04:00\",\"area\":\"Sector 4C\"}]",
        "received" : "2021-04-01T05:10:43.956Z"
      }, {
        "updatedField" : "STAND_SLOT",
        "previous" : "[{\"name\":\"401R\",\"externalName\":\"401R\",\"startTime\":\"2021-04-01T11:18:00+04:00\",\"endTime\":\"2021-04-01T12:25:00+04:00\",\"area\":\"Sector 4C\"}]",
        "current" : "[{\"name\":\"401R\",\"externalName\":\"401R\",\"startTime\":\"2021-04-01T11:06:00+04:00\",\"endTime\":\"2021-04-01T12:25:00+04:00\",\"area\":\"Sector 4C\"}]",
        "received" : "2021-04-01T07:06:13.922Z"
      }, {
        "updatedField" : "STATUS",
        "previous" : "SC",
        "current" : "FC",
        "received" : "2021-04-01T07:52:30.967Z"
      }, {
        "updatedField" : "STATUS",
        "previous" : "FC",
        "current" : "GC",
        "received" : "2021-04-01T08:13:56.299Z"
      }, {
        "updatedField" : "ESTIMATED",
        "current" : "2021-04-01T13:58:00+05:30",
        "received" : "2021-04-01T08:22:41.375Z"
      }, {
        "updatedField" : "GATE_SLOT",
        "previous" : "[{\"name\":\"C3\",\"externalName\":\"C3\",\"startTime\":\"2021-04-01T11:25:00+04:00\",\"endTime\":\"2021-04-01T12:25:00+04:00\",\"area\":\"Pier C Contact\"}]",
        "current" : "[{\"name\":\"C3\",\"externalName\":\"C3\",\"startTime\":\"2021-04-01T11:28:00+04:00\",\"endTime\":\"2021-04-01T12:28:00+04:00\",\"area\":\"Pier C Contact\"}]",
        "received" : "2021-04-01T08:22:41.375Z"
      }, {
        "updatedField" : "EVENTS",
        "previous" : "{}",
        "current" : "{\"EOBT\":\"2021-04-01T12:28:00+04:00\"}",
        "received" : "2021-04-01T08:22:41.375Z"
      }, {
        "updatedField" : "STAND_SLOT",
        "previous" : "[{\"name\":\"401R\",\"externalName\":\"401R\",\"startTime\":\"2021-04-01T11:06:00+04:00\",\"endTime\":\"2021-04-01T12:25:00+04:00\",\"area\":\"Sector 4C\"}]",
        "current" : "[{\"name\":\"401R\",\"externalName\":\"401R\",\"startTime\":\"2021-04-01T11:06:00+04:00\",\"endTime\":\"2021-04-01T12:28:00+04:00\",\"area\":\"Sector 4C\"}]",
        "received" : "2021-04-01T08:22:41.376Z"
      }, {
        "updatedField" : "DELAY_PREDICTION",
        "previous" : "{\"minutes\":55,\"prediction\":\"2021-04-01T13:20:00+04:00\"}",
        "current" : "{\"minutes\":65,\"prediction\":\"2021-04-01T13:30:00+04:00\"}",
        "received" : "2021-04-01T08:25:12.156Z"
      } ]
    },
    "arrival" : {
      "version" : 39
    }
  } ]
}

4 Error Response

4.1 Response fields

Path Type Description

errors

Object

Object that holds the error information

errors.error[].description

String

Error Description

errors.error[]

Array

Array of errors

errors.error[].invalidParam

String

Indicates the invalid query parameter

errors.error[].code

Number

API Internal Error Code

4.2 HTTP Response

HTTP/1.1 400 Bad Request
Content-Type: application/json
Content-Length: 159
{
  "errors" : {
  "error" : [ {
  "description" : "Error Description",
  "code" : 9999,
  "invalidParam" : "parameterName"
  } ]
  }
}

5 Notes

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

See 'Appendix E - Flights Response Examples' for sample 'local' and 'full' response
payloads.

6 Appendix A - Status Codes

Code Description

AD

Arrived-Diverted

AP

Approach

AR

Arrived

AT

See Agent

BC

Boarding Complete

BD

Boarding

BO

Boarded

CD

Baggage Delay

CO

Closed

CL

Closed

CX

Cancelled

DE

Deleted

DL

Delayed

DP

Departed

DV

Diverted

EN

Enroute

EX

Expected

FB

First Bag Unloaded

FC

Final Call

GC

Gate Closed

GG

Go To Gate

GT

Gate Time (Gate Time HH:MM can be found in gateInfo field)

IA

In Air

ID

In Air-Diverted

IR

In Range

LB

Last Bag Unloaded

LD

Landed-Diverted

LN

Landed

LR

Landed-Recovered

OG

Landed (On Ground)

ON

On Time

TX

Taxiing

PD

Possible Delay

RA

Arrived-Recovered

RE

In Air-Recovered

RG

Return To Gate

SC

Scheduled

UN

Unknown

VN

TEST

WX

Weather

7 Appendix B - V2 Flight Details Response Schema

{
  "type" : "object",
  "properties" : {
    "flightRecords" : {
      "type" : "array",
      "items" : {
        "type" : "object",
        "properties" : {
          "flightIdentifier" : {
            "type" : "object",
            "properties" : {
              "operatingCarrier" : {
                "type" : "object",
                "properties" : {
                  "iataCode" : {
                    "type" : "string"
                  },
                  "icaoCode" : {
                    "type" : "string"
                  },
                  "flightNumber" : {
                    "type" : "string"
                  },
                  "name" : {
                    "type" : "string"
                  }
                }
              },
              "marketingCarriers" : {
                "type" : "array",
                "items" : {
                  "type" : "object",
                  "properties" : {
                    "iataCode" : {
                      "type" : "string"
                    },
                    "icaoCode" : {
                      "type" : "string"
                    },
                    "flightNumber" : {
                      "type" : "string"
                    },
                    "name" : {
                      "type" : "string"
                    }
                  }
                }
              },
              "aircraft" : {
                "type" : "object",
                "properties" : {
                  "iataCode" : {
                    "type" : "string"
                  },
                  "icaoCode" : {
                    "type" : "string"
                  },
                  "model" : {
                    "type" : "string"
                  },
                  "registration" : {
                    "type" : "string"
                  },
                  "callSign" : {
                    "type" : "string"
                  }
                }
              }
            }
          },
          "flightStats" : {
            "type" : "object",
            "properties" : {
              "passengers" : {
                "type" : "object",
                "properties" : {
                  "bookedTotal" : {
                    "type" : "string"
                  },
                  "bookedFirst" : {
                    "type" : "string"
                  },
                  "bookedBusiness" : {
                    "type" : "string"
                  },
                  "bookedEconomy" : {
                    "type" : "string"
                  },
                  "actualTotal" : {
                    "type" : "string"
                  },
                  "actualFirst" : {
                    "type" : "string"
                  },
                  "actualBusiness" : {
                    "type" : "string"
                  },
                  "actualEconomy" : {
                    "type" : "string"
                  },
                  "actualTransfer" : {
                    "type" : "string"
                  },
                  "actualTransit" : {
                    "type" : "string"
                  },
                  "reducedMobility" : {
                    "type" : "string"
                  },
                  "adult" : {
                    "type" : "string"
                  },
                  "child" : {
                    "type" : "string"
                  },
                  "infant" : {
                    "type" : "string"
                  }
                }
              },
              "baggage" : {
                "type" : "object",
                "properties" : {
                  "count" : {
                    "type" : "string"
                  },
                  "load" : {
                    "type" : "string"
                  },
                  "totalWeight" : {
                    "type" : "string"
                  },
                  "cargo" : {
                    "type" : "string"
                  },
                  "mail" : {
                    "type" : "string"
                  }
                }
              }
            }
          },
          "departure" : {
            "type" : "object",
            "properties" : {
              "airport" : {
                "type" : "object",
                "properties" : {
                  "iataCode" : {
                    "type" : "string"
                  },
                  "icaoCode" : {
                    "type" : "string"
                  },
                  "name" : {
                    "type" : "string"
                  },
                  "city" : {
                    "type" : "string"
                  },
                  "cityText" : {
                    "type" : "string"
                  }
                }
              },
              "scheduled" : {
                "type" : "any"
              },
              "estimated" : {
                "type" : "any"
              },
              "actual" : {
                "type" : "any"
              },
              "status" : {
                "type" : "string"
              },
              "statusText" : {
                "type" : "string"
              },
              "terminal" : {
                "type" : "string"
              },
              "gate" : {
                "type" : "string"
              },
              "gateRemark" : {
                "type" : "string"
              },
              "gateRemarkText" : {
                "type" : "string"
              },
              "carousel" : {
                "type" : "string"
              },
              "stand" : {
                "type" : "string"
              },
              "checkIn" : {
                "type" : "string"
              },
              "chute" : {
                "type" : "string"
              },
              "standSlots" : {
                "type" : "array",
                "items" : {
                  "type" : "object",
                  "properties" : {
                    "name" : {
                      "type" : "string"
                    },
                    "externalName" : {
                      "type" : "string"
                    },
                    "startTime" : {
                      "type" : "any"
                    },
                    "endTime" : {
                      "type" : "any"
                    },
                    "area" : {
                      "type" : "string"
                    }
                  }
                }
              },
              "checkinSlots" : {
                "type" : "array",
                "items" : {
                  "type" : "object",
                  "properties" : {
                    "name" : {
                      "type" : "string"
                    },
                    "externalName" : {
                      "type" : "string"
                    },
                    "startTime" : {
                      "type" : "any"
                    },
                    "endTime" : {
                      "type" : "any"
                    },
                    "area" : {
                      "type" : "string"
                    }
                  }
                }
              },
              "carouselSlots" : {
                "type" : "array",
                "items" : {
                  "type" : "object",
                  "properties" : {
                    "name" : {
                      "type" : "string"
                    },
                    "externalName" : {
                      "type" : "string"
                    },
                    "startTime" : {
                      "type" : "any"
                    },
                    "endTime" : {
                      "type" : "any"
                    },
                    "area" : {
                      "type" : "string"
                    }
                  }
                }
              },
              "gateSlots" : {
                "type" : "array",
                "items" : {
                  "type" : "object",
                  "properties" : {
                    "name" : {
                      "type" : "string"
                    },
                    "externalName" : {
                      "type" : "string"
                    },
                    "startTime" : {
                      "type" : "any"
                    },
                    "endTime" : {
                      "type" : "any"
                    },
                    "area" : {
                      "type" : "string"
                    }
                  }
                }
              },
              "chuteSlots" : {
                "type" : "array",
                "items" : {
                  "type" : "object",
                  "properties" : {
                    "name" : {
                      "type" : "string"
                    },
                    "externalName" : {
                      "type" : "string"
                    },
                    "startTime" : {
                      "type" : "any"
                    },
                    "endTime" : {
                      "type" : "any"
                    },
                    "area" : {
                      "type" : "string"
                    }
                  }
                }
              },
              "route" : {
                "type" : "array",
                "items" : {
                  "type" : "object",
                  "properties" : {
                    "iataCode" : {
                      "type" : "string"
                    },
                    "icaoCode" : {
                      "type" : "string"
                    },
                    "sequenceNumber" : {
                      "type" : "integer"
                    }
                  }
                }
              },
              "customProperties" : {
                "type" : "array",
                "items" : {
                  "type" : "object",
                  "properties" : {
                    "key" : {
                      "type" : "string"
                    },
                    "value" : {
                      "type" : "string"
                    }
                  }
                }
              },
              "events" : {
                "type" : "object",
                "properties" : {
                  "ALDT" : {
                    "type" : "any"
                  },
                  "AIBT" : {
                    "type" : "any"
                  },
                  "AOBT" : {
                    "type" : "any"
                  },
                  "ATOT" : {
                    "type" : "any"
                  },
                  "ELDT" : {
                    "type" : "any"
                  },
                  "EIBT" : {
                    "type" : "any"
                  },
                  "EOBT" : {
                    "type" : "any"
                  },
                  "ETOT" : {
                    "type" : "any"
                  },
                  "TOBT" : {
                    "type" : "any"
                  },
                  "TTOT" : {
                    "type" : "any"
                  }
                }
              },
              "diversion" : {
                "type" : "object",
                "properties" : {
                  "original" : {
                    "type" : "object",
                    "properties" : {
                      "iataCode" : {
                        "type" : "string"
                      },
                      "icaoCode" : {
                        "type" : "string"
                      },
                      "flightNumber" : {
                        "type" : "string"
                      },
                      "name" : {
                        "type" : "string"
                      },
                      "airport" : {
                        "type" : "object",
                        "properties" : {
                          "iataCode" : {
                            "type" : "string"
                          },
                          "icaoCode" : {
                            "type" : "string"
                          },
                          "name" : {
                            "type" : "string"
                          },
                          "city" : {
                            "type" : "string"
                          },
                          "cityText" : {
                            "type" : "string"
                          }
                        }
                      },
                      "scheduled" : {
                        "type" : "string"
                      }
                    }
                  },
                  "recovery" : {
                    "type" : "object",
                    "properties" : {
                      "iataCode" : {
                        "type" : "string"
                      },
                      "icaoCode" : {
                        "type" : "string"
                      },
                      "flightNumber" : {
                        "type" : "string"
                      },
                      "name" : {
                        "type" : "string"
                      },
                      "airport" : {
                        "type" : "object",
                        "properties" : {
                          "iataCode" : {
                            "type" : "string"
                          },
                          "icaoCode" : {
                            "type" : "string"
                          },
                          "name" : {
                            "type" : "string"
                          },
                          "city" : {
                            "type" : "string"
                          },
                          "cityText" : {
                            "type" : "string"
                          }
                        }
                      },
                      "scheduled" : {
                        "type" : "string"
                      }
                    }
                  }
                }
              },
              "delayPrediction" : {
                "type" : "object",
                "properties" : {
                  "minutes" : {
                    "type" : "integer"
                  },
                  "prediction" : {
                    "type" : "string"
                  },
                  "message" : {
                    "type" : "string"
                  }
                }
              }
            }
          },
          "arrival" : {
            "type" : "object",
            "properties" : {
              "airport" : {
                "type" : "object",
                "properties" : {
                  "iataCode" : {
                    "type" : "string"
                  },
                  "icaoCode" : {
                    "type" : "string"
                  },
                  "name" : {
                    "type" : "string"
                  },
                  "city" : {
                    "type" : "string"
                  },
                  "cityText" : {
                    "type" : "string"
                  }
                }
              },
              "scheduled" : {
                "type" : "any"
              },
              "estimated" : {
                "type" : "any"
              },
              "actual" : {
                "type" : "any"
              },
              "status" : {
                "type" : "string"
              },
              "statusText" : {
                "type" : "string"
              },
              "terminal" : {
                "type" : "string"
              },
              "gate" : {
                "type" : "string"
              },
              "gateRemark" : {
                "type" : "string"
              },
              "gateRemarkText" : {
                "type" : "string"
              },
              "carousel" : {
                "type" : "string"
              },
              "stand" : {
                "type" : "string"
              },
              "checkIn" : {
                "type" : "string"
              },
              "chute" : {
                "type" : "string"
              },
              "standSlots" : {
                "type" : "array",
                "items" : {
                  "type" : "object",
                  "properties" : {
                    "name" : {
                      "type" : "string"
                    },
                    "externalName" : {
                      "type" : "string"
                    },
                    "startTime" : {
                      "type" : "any"
                    },
                    "endTime" : {
                      "type" : "any"
                    },
                    "area" : {
                      "type" : "string"
                    }
                  }
                }
              },
              "checkinSlots" : {
                "type" : "array",
                "items" : {
                  "type" : "object",
                  "properties" : {
                    "name" : {
                      "type" : "string"
                    },
                    "externalName" : {
                      "type" : "string"
                    },
                    "startTime" : {
                      "type" : "any"
                    },
                    "endTime" : {
                      "type" : "any"
                    },
                    "area" : {
                      "type" : "string"
                    }
                  }
                }
              },
              "carouselSlots" : {
                "type" : "array",
                "items" : {
                  "type" : "object",
                  "properties" : {
                    "name" : {
                      "type" : "string"
                    },
                    "externalName" : {
                      "type" : "string"
                    },
                    "startTime" : {
                      "type" : "any"
                    },
                    "endTime" : {
                      "type" : "any"
                    },
                    "area" : {
                      "type" : "string"
                    }
                  }
                }
              },
              "gateSlots" : {
                "type" : "array",
                "items" : {
                  "type" : "object",
                  "properties" : {
                    "name" : {
                      "type" : "string"
                    },
                    "externalName" : {
                      "type" : "string"
                    },
                    "startTime" : {
                      "type" : "any"
                    },
                    "endTime" : {
                      "type" : "any"
                    },
                    "area" : {
                      "type" : "string"
                    }
                  }
                }
              },
              "chuteSlots" : {
                "type" : "array",
                "items" : {
                  "type" : "object",
                  "properties" : {
                    "name" : {
                      "type" : "string"
                    },
                    "externalName" : {
                      "type" : "string"
                    },
                    "startTime" : {
                      "type" : "any"
                    },
                    "endTime" : {
                      "type" : "any"
                    },
                    "area" : {
                      "type" : "string"
                    }
                  }
                }
              },
              "route" : {
                "type" : "array",
                "items" : {
                  "type" : "object",
                  "properties" : {
                    "iataCode" : {
                      "type" : "string"
                    },
                    "icaoCode" : {
                      "type" : "string"
                    },
                    "sequenceNumber" : {
                      "type" : "integer"
                    }
                  }
                }
              },
              "customProperties" : {
                "type" : "array",
                "items" : {
                  "type" : "object",
                  "properties" : {
                    "key" : {
                      "type" : "string"
                    },
                    "value" : {
                      "type" : "string"
                    }
                  }
                }
              },
              "events" : {
                "type" : "object",
                "properties" : {
                  "ALDT" : {
                    "type" : "any"
                  },
                  "AIBT" : {
                    "type" : "any"
                  },
                  "AOBT" : {
                    "type" : "any"
                  },
                  "ATOT" : {
                    "type" : "any"
                  },
                  "ELDT" : {
                    "type" : "any"
                  },
                  "EIBT" : {
                    "type" : "any"
                  },
                  "EOBT" : {
                    "type" : "any"
                  },
                  "ETOT" : {
                    "type" : "any"
                  },
                  "TOBT" : {
                    "type" : "any"
                  },
                  "TTOT" : {
                    "type" : "any"
                  }
                }
              },
              "diversion" : {
                "type" : "object",
                "properties" : {
                  "original" : {
                    "type" : "object",
                    "properties" : {
                      "iataCode" : {
                        "type" : "string"
                      },
                      "icaoCode" : {
                        "type" : "string"
                      },
                      "flightNumber" : {
                        "type" : "string"
                      },
                      "name" : {
                        "type" : "string"
                      },
                      "airport" : {
                        "type" : "object",
                        "properties" : {
                          "iataCode" : {
                            "type" : "string"
                          },
                          "icaoCode" : {
                            "type" : "string"
                          },
                          "name" : {
                            "type" : "string"
                          },
                          "city" : {
                            "type" : "string"
                          },
                          "cityText" : {
                            "type" : "string"
                          }
                        }
                      },
                      "scheduled" : {
                        "type" : "string"
                      }
                    }
                  },
                  "recovery" : {
                    "type" : "object",
                    "properties" : {
                      "iataCode" : {
                        "type" : "string"
                      },
                      "icaoCode" : {
                        "type" : "string"
                      },
                      "flightNumber" : {
                        "type" : "string"
                      },
                      "name" : {
                        "type" : "string"
                      },
                      "airport" : {
                        "type" : "object",
                        "properties" : {
                          "iataCode" : {
                            "type" : "string"
                          },
                          "icaoCode" : {
                            "type" : "string"
                          },
                          "name" : {
                            "type" : "string"
                          },
                          "city" : {
                            "type" : "string"
                          },
                          "cityText" : {
                            "type" : "string"
                          }
                        }
                      },
                      "scheduled" : {
                        "type" : "string"
                      }
                    }
                  }
                }
              },
              "delayPrediction" : {
                "type" : "object",
                "properties" : {
                  "minutes" : {
                    "type" : "integer"
                  },
                  "prediction" : {
                    "type" : "string"
                  },
                  "message" : {
                    "type" : "string"
                  }
                }
              }
            }
          },
          "serviceType" : {
            "type" : "string"
          },
          "duration" : {
            "type" : "integer"
          },
          "metadata" : {
            "type" : "object",
            "properties" : {
              "provider" : {
                "type" : "string"
              },
              "lastUpdateTime" : {
                "type" : "any"
              }
            }
          }
        }
      }
    }
  }
}

8 Appendix C - V2 Flight Updates Response Schema

{
  "type" : "object",
  "properties" : {
    "flightRecords" : {
      "type" : "array",
      "items" : {
        "type" : "object",
        "properties" : {
          "flightIdentifier" : {
            "type" : "object",
            "properties" : {
              "operatingCarrier" : {
                "type" : "object",
                "properties" : {
                  "iataCode" : {
                    "type" : "string"
                  },
                  "icaoCode" : {
                    "type" : "string"
                  },
                  "flightNumber" : {
                    "type" : "string"
                  },
                  "name" : {
                    "type" : "string"
                  }
                }
              },
              "marketingCarriers" : {
                "type" : "array",
                "items" : {
                  "type" : "object",
                  "properties" : {
                    "iataCode" : {
                      "type" : "string"
                    },
                    "icaoCode" : {
                      "type" : "string"
                    },
                    "flightNumber" : {
                      "type" : "string"
                    },
                    "name" : {
                      "type" : "string"
                    }
                  }
                }
              }
            }
          },
          "departure" : {
            "type" : "object",
            "properties" : {
              "scheduled" : {
                "type" : "any"
              },
              "version" : {
                "type" : "integer"
              },
              "updates" : {
                "type" : "array",
                "items" : {
                  "type" : "object",
                  "properties" : {
                    "updatedField" : {
                      "type" : "string",
                      "enum" : [ "GATE", "CLAIM", "TERMINAL", "ACTUAL", "ESTIMATED", "SCHEDULED", "AIRCRAFT", "DURATION", "TAILNO", "STATUS", "SERVICE_TYPE", "STAND", "CHECK_IN", "AIRCRAFT_OBJECT", "STAND_SLOT", "CHECK_IN_SLOT", "CAROUSEL_SLOT", "GATE_SLOT", "CHUTE_SLOT", "ROUTE", "FLIGHT_STATS", "CUSTOM_PROPERTIES", "MARKETING_CARRIER", "EVENTS", "DIVERSION", "AIRPORT", "RECOVERY", "ORIGINAL", "DELAY_PREDICTION" ]
                    },
                    "previous" : {
                      "type" : "string"
                    },
                    "current" : {
                      "type" : "string"
                    },
                    "received" : {
                      "type" : "any"
                    },
                    "metadata" : {
                      "type" : "object",
                      "properties" : {
                        "provider" : {
                          "type" : "string"
                        },
                        "lastUpdateTime" : {
                          "type" : "any"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "arrival" : {
            "type" : "object",
            "properties" : {
              "scheduled" : {
                "type" : "any"
              },
              "version" : {
                "type" : "integer"
              },
              "updates" : {
                "type" : "array",
                "items" : {
                  "type" : "object",
                  "properties" : {
                    "updatedField" : {
                      "type" : "string",
                      "enum" : [ "GATE", "CLAIM", "TERMINAL", "ACTUAL", "ESTIMATED", "SCHEDULED", "AIRCRAFT", "DURATION", "TAILNO", "STATUS", "SERVICE_TYPE", "STAND", "CHECK_IN", "AIRCRAFT_OBJECT", "STAND_SLOT", "CHECK_IN_SLOT", "CAROUSEL_SLOT", "GATE_SLOT", "CHUTE_SLOT", "ROUTE", "FLIGHT_STATS", "CUSTOM_PROPERTIES", "MARKETING_CARRIER", "EVENTS", "DIVERSION", "AIRPORT", "RECOVERY", "ORIGINAL", "DELAY_PREDICTION" ]
                    },
                    "previous" : {
                      "type" : "string"
                    },
                    "current" : {
                      "type" : "string"
                    },
                    "received" : {
                      "type" : "any"
                    },
                    "metadata" : {
                      "type" : "object",
                      "properties" : {
                        "provider" : {
                          "type" : "string"
                        },
                        "lastUpdateTime" : {
                          "type" : "any"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "metadata" : {
            "type" : "object",
            "properties" : {
              "provider" : {
                "type" : "string"
              },
              "lastUpdateTime" : {
                "type" : "any"
              }
            }
          }
        }
      }
    }
  }
}

9 Appendix D - Update Fields

Field Description

NEW_FLIGHT

Identifies a new flight created within FLIFO. This is the first possible notification which can be generated for a flight

GATE

Gate change

CLAIM

Baggage Claim/Carousel

ACTUAL

Actual time of departure or arrival

ESTIMATED

Estimated time of departure or arrival

AIRCRAFT

Aircraft type change

TERMINAL

Terminal change

DURATION

Flight duration change

TAILNO

Tail number change

STATUS

Flight status change.

SCHEDULED

Scheduled departure/arrival time change

SERVICE_TYPE

Change of flight service type

STAND

Stand allocation change

STAND_SLOT

Sand slot change

CHECK_IN

Check in desk allocation

CHECK_IN_SLOT

Check in slot change

AIRCRAFT_OBJECT

Aircraft object change

CAROUSEL_SLOT

Carousel slot change

GATE_SLOT

Gate slot change

CHUTE_SLOT

Baggage chute slot change

ROUTE

Route change

FLIGHT_STATS

Flight Stats change i.e. passenger counts/baggage counts

EVENTS

Events change i.e. updates to off/on block times

MARKETING_CARRIER

Change to listed marketing/codeshare flight details

CUSTOM_PROPERTIES

Change to details contained within the custom properties key value mappings

DIVERSION

Diversion details change

DELAY_PREDICTION

Delay Prediction change

10 Appendix E - Flights Response Examples

'view' parameter response payload formats
/v1/flights/airport/MCT/airline/UL/direction/D?view=#local# /v1/flights/airport/MCT/airline/UL/direction/D?view=#full#
{
    "flightRecords": [
        {
            "flightIdentifier": {
                "operatingCarrier": {
                    "iataCode": "UL",
                    "flightNumber": "1512",
                    "name": "SriLankan Airlines"
                },
                "aircraft": {
                    "iataCode": "321",
                    "icaoCode": "A321",
                    "model": "A321",
                    "registration": "4RAND"
                }
            },
            "flightStats": {
                "passengers": {
                    "bookedTotal": "120",
                    "adult": "109",
                    "child": "2",
                    "infant": "2"
                },
                "baggage": {
                    "count": "235",
                    "load": "3661",
                    "cargo": "0",
                    "mail": "0"
                }
            },
            "departure": {
                "airport": {
                    "iataCode": "CMB",
                    "cityText": "Colombo"
                },
                "scheduled": "2021-04-01T12:25:00+04:00",
                "estimated": "2021-04-01T14:43:00+05:30",
                "actual": "2021-04-01T13:48:00+05:30",
                "status": "DP",
                "statusText": "Departed",
                "terminal": "T1",
                "gate": "C3",
                "stand": "401R",
                "checkIn": "F10",
                "chute": "S1",
                "standSlots": [
                    {
                        "name": "401R",
                        "externalName": "401R",
                        "startTime": "2021-04-01T11:06:00+04:00",
                        "endTime": "2021-04-01T12:18:00+04:00",
                        "area": "Sector 4C"
                    }
                ],
                "checkinSlots": [
                    {
                        "name": "F10",
                        "externalName": "F10",
                        "startTime": "2021-04-01T07:40:00+04:00",
                        "endTime": "2021-04-01T11:25:00+04:00",
                        "area": "Check-In F"
                    },
                    {
                        "name": "F11",
                        "externalName": "F11",
                        "startTime": "2021-04-01T07:40:00+04:00",
                        "endTime": "2021-04-01T11:25:00+04:00",
                        "area": "Check-In F"
                    },
                    {
                        "name": "F12",
                        "externalName": "F12",
                        "startTime": "2021-04-01T07:40:00+04:00",
                        "endTime": "2021-04-01T11:25:00+04:00",
                        "area": "Check-In F"
                    },
                    {
                        "name": "F8",
                        "externalName": "F8",
                        "startTime": "2021-04-01T07:40:00+04:00",
                        "endTime": "2021-04-01T11:25:00+04:00",
                        "area": "Check-In F"
                    },
                    {
                        "name": "F9",
                        "externalName": "F9",
                        "startTime": "2021-04-01T07:40:00+04:00",
                        "endTime": "2021-04-01T11:25:00+04:00",
                        "area": "Check-In F"
                    }
                ],
                "gateSlots": [
                    {
                        "name": "C3",
                        "externalName": "C3",
                        "startTime": "2021-04-01T11:18:00+04:00",
                        "endTime": "2021-04-01T12:18:00+04:00",
                        "area": "Pier C Contact"
                    }
                ],
                "chuteSlots": [
                    {
                        "name": "S1",
                        "externalName": "S1",
                        "startTime": "2021-04-01T09:25:00+04:00",
                        "endTime": "2021-04-01T11:25:00+04:00",
                        "area": "Chutes"
                    }
                ],
                "route": [
                    {
                        "sequenceNumber": 0
                    }
                ],
                "customProperties": [
                    {
                        "key": "S---_Status",
                        "value": "SCH"
                    }
                ],
                "events": {
                    "AOBT": "2021-04-01T12:18:00+04:00",
                    "ATOT": "2021-04-01T12:26:00+04:00",
                    "EOBT": "2021-04-01T13:13:00+04:00"
                }
            },
            "serviceType": "J",
            "duration": 255
        }
    ]
}
{
    "flightRecords": [
        {
            "flightIdentifier": {
                "operatingCarrier": {
                    "iataCode": "UL",
                    "flightNumber": "1512",
                    "name": "SriLankan Airlines"
                },
                "aircraft": {
                    "iataCode": "321",
                    "icaoCode": "A321",
                    "model": "A321",
                    "registration": "4RAND"
                }
            },
            "flightStats": {
                "passengers": {
                    "bookedTotal": "120",
                    "adult": "109",
                    "child": "2",
                    "infant": "2"
                },
                "baggage": {
                    "count": "235",
                    "load": "3661",
                    "cargo": "0",
                    "mail": "0"
                }
            },
            "departure": {
                "airport": {
                    "iataCode": "MCT",
                    "cityText": "Muscat"
                },
                "scheduled": "2021-04-01T12:25:00+04:00",
                "estimated": "2021-04-01T14:43:00+05:30",
                "actual": "2021-04-01T13:48:00+05:30",
                "status": "DP",
                "statusText": "Departed",
                "terminal": "T1",
                "gate": "C3",
                "stand": "401R",
                "checkIn": "F10",
                "chute": "S1",
                "standSlots": [
                    {
                        "name": "401R",
                        "externalName": "401R",
                        "startTime": "2021-04-01T11:06:00+04:00",
                        "endTime": "2021-04-01T12:18:00+04:00",
                        "area": "Sector 4C"
                    }
                ],
                "checkinSlots": [
                    {
                        "name": "F10",
                        "externalName": "F10",
                        "startTime": "2021-04-01T07:40:00+04:00",
                        "endTime": "2021-04-01T11:25:00+04:00",
                        "area": "Check-In F"
                    },
                    {
                        "name": "F11",
                        "externalName": "F11",
                        "startTime": "2021-04-01T07:40:00+04:00",
                        "endTime": "2021-04-01T11:25:00+04:00",
                        "area": "Check-In F"
                    },
                    {
                        "name": "F12",
                        "externalName": "F12",
                        "startTime": "2021-04-01T07:40:00+04:00",
                        "endTime": "2021-04-01T11:25:00+04:00",
                        "area": "Check-In F"
                    },
                    {
                        "name": "F8",
                        "externalName": "F8",
                        "startTime": "2021-04-01T07:40:00+04:00",
                        "endTime": "2021-04-01T11:25:00+04:00",
                        "area": "Check-In F"
                    },
                    {
                        "name": "F9",
                        "externalName": "F9",
                        "startTime": "2021-04-01T07:40:00+04:00",
                        "endTime": "2021-04-01T11:25:00+04:00",
                        "area": "Check-In F"
                    }
                ],
                "gateSlots": [
                    {
                        "name": "C3",
                        "externalName": "C3",
                        "startTime": "2021-04-01T11:18:00+04:00",
                        "endTime": "2021-04-01T12:18:00+04:00",
                        "area": "Pier C Contact"
                    }
                ],
                "chuteSlots": [
                    {
                        "name": "S1",
                        "externalName": "S1",
                        "startTime": "2021-04-01T09:25:00+04:00",
                        "endTime": "2021-04-01T11:25:00+04:00",
                        "area": "Chutes"
                    }
                ],
                "route": [
                    {
                        "sequenceNumber": 0
                    }
                ],
                "customProperties": [
                    {
                        "key": "S---_Status",
                        "value": "SCH"
                    }
                ],
                "events": {
                    "AOBT": "2021-04-01T12:18:00+04:00",
                    "ATOT": "2021-04-01T12:26:00+04:00",
                    "EOBT": "2021-04-01T13:13:00+04:00"
                }
            },
            "arrival": {
                "airport": {
                    "iataCode": "CMB",
                    "cityText": "Colombo"
                },
                "scheduled": "2021-04-01T18:10:00+05:30",
                "actual": "2021-04-01T17:35:00+05:30",
                "status": "LN",
                "statusText": "Landed"
            },
            "serviceType": "J",
            "duration": 255
        }
    ]
}

11 Appendix F - Historical Flight Use Cases

11.1 Flight Updates Use Cases

Scenario:

As an API user I want to make a request to the Historical API to return all updates for flights at a given airport within a provided timeframe

Request:

GET /historical/v2/flights/updates/airport/AMS?operationDateFrom=2020-01-01T12:00:00-0000&operationDateTo=2020-01-01T12:30:00-0000

Response:

List of flight update records for AMS flights between January 1st at 12pm until 12.30pm

Scenario:

As an API user I want to make a request to the Historical API to return all updates for flights from a specific airline at a given airport within a provided timeframe

Request:

GET /historical/v2/flights/updates/airport/AMS/airline/KL?operationDateFrom=2020-01-01T12:00:00-0000&operationDateTo=2020-01-01T12:30:00-0000

Response:

List of flight update records for KL flights to and from AMS between January 1st at 12pm until 12.30pm

Scenario:

As an API user I want to make a request to the Historical API to return all updates for flights from a specific airline, with a specific flight number, at a given airport within a provided timeframe

Request:

GET /historical/v2/flights/updates/airport/AMS/airline/KL/flightNumber/1417?operationDateFrom=2020-01-01T12:00:00-0000&operationDateTo=2020-01-01T12:30:00-0000

Response:

List of flight update records for KL flights with a flight number of 1417 to and from AMS between January 1st at 12pm until 12.30pm

11.2 Flight Details Use Cases

Scenario:

As an API user I want to make a request to the Historical API to return all flight records arriving at a specific airport

Request:

GET /historical/v2/flights/airport/AMS/direction/A

Response:

List of flight records for flights arriving at AMS airport

Scenario:

As an API user I want to make a request to the Historical API to return all flight records departing a specific airport

Request:

GET /historical/v2/flights/airport/AMS/direction/D

Response:

List of flight records for flights departing at AMS airport

Scenario:

As an API user I want to make a request to the Historical API to return all flight records arriving at a given airport for a specific airline and flight number

Request:

GET /historical/v2/flights/airport/AMS/airline/KL/flightNumber/1417/direction/A

Response:

List of flight records for flights arriving at AMS airport with an airline code of KL, and a flight number of 1417

Scenario:

As an API user I want to make a request to the Historical API to return all flight records departing from a given airport for a specific airline and flight number

Request:

GET /historical/v2/flights/airport/AMS/airline/KL/flightNumber/1417/direction/D

Response:

List of flight records for flights departing from AMS airport with an airline code of KL, and a flight number of 1417

Scenario:

As an API user I want to make a request to the Historical API to return all flight records arriving at a given airport for a specific airline

Request:

GET /historical/v2/flights/airport/AMS/airline/KL/direction/A

Response:

List of flight records for flights arriving at AMS airport with an airline code of KL

Scenario:

As an API user I want to make a request to the Historical API to return all flight records departing a given airport for a specific airline

Request:

GET /historical/v2/flights/airport/AMS/airline/KL/direction/D

Response:

List of flight records for flights departing from AMS airport with an airline code of KL

Scenario:

As an API user I want to make a request to the Historical API to return all flight records departing a given airport for a specific airline

Request:

GET /historical/v2/flights/airline/KL/flightNumber/1417

Response:

List of a single record for a flight with an airline code of KL and a flight number of 1417


Last updated 2022-10-25 11:59:46 +0100

About us

We are the world's leading specialist in air transport communications and IT solutions. 

 

bottom navigation SITA logo

Contact