FlightRecord
The Flight Record API returns the current status of the flight. The requestor can additionally subscribe for status update notifications. The notifyEndpoint
defined for the flight subscribed to will be called with the status update payload. The maximum URL length is 256 characters.
Format
Verb | Request |
---|---|
GET |
https://host/flifo/v3/flight/{airport}/{airline}/{flightNumber}/{adi} |
Path Parameters
Key | Description | Required |
---|---|---|
airport |
The airport IATA code. | Yes |
airline |
The airline IATA code. | Yes |
flightNumber |
Flight Number. | Yes |
adi |
Departure or Arrival Indicator: 'A' or 'a'
Departure Indicator: 'D' or 'd' |
Yes |
Request Query Parameters
Key | Description | Required |
---|---|---|
subscribeForUpdates |
Request future notifications for this flight (true/false). Default is false. | No |
notifyEndpoint |
If subscribeForUpdates is true, endpoint where updates are to be delivered. Required only if subscribeForUpdates is true. | No |
operationDate |
Date of operation for the flight based on date at airport used in search (defaults to current UTC day). | No |
callback |
Name of callback function (JSONP). | No |
Description
The Flight Record api returns the current status of the flight. The requestor can additionally subscribe for status update notifications. The notifyEndpoint defined for the flight subscribed to will be called with the status update payload. The maximum URL length is 256 characters.
Payload Example
Request
https://flifo.api.aero/flifo/v3/flight/LAX/DL/40/D?operationDate=2018-11-20&subscribeForUpdates=true¬ifyEndpoint=https://my.endpoint.com/updates
Response
{
"airportCode": "LAX",
"airlineCode": "DL",
"flightNumber": "40",
"flightDate": "2018-11-20",
"adi": "D",
"subscribedForUpdates": true,
"flightRecord": [
{
"operatingCarrier": {
"airlineCode": "DL",
"flightNumber": "40",
"airline": "Delta Air Lines"
},
"airportCode": "JFK",
"aircraft": "767",
"status": "ON",
"statusText": "On Time",
"scheduled": "2018-11-20T09:15:00-0800",
"estimated": "2018-11-20T09:15:00-0800",
"city": "New York",
"tailNumber": "N184DN",
"gate": "22",
"marketingCarriers": [
{
"airlineCode": "VA",
"flightNumber": "6428",
"airline": "Virgin Australia"
},
{
"airlineCode": "G3",
"flightNumber": "8087",
"airline": "City Connexion Airlines"
},
{
"airlineCode": "MU",
"flightNumber": "8833",
"airline": "China Eastern Airlines"
},
{
"airlineCode": "AZ",
"flightNumber": "3318",
"airline": "Alitalia"
},
{
"airlineCode": "KL",
"flightNumber": "5263",
"airline": "KLM Royal Dutch Airlines"
},
{
"airlineCode": "UX",
"flightNumber": "3341",
"airline": "Air Europa"
},
{
"airlineCode": "VS",
"flightNumber": "3382",
"airline": "Virgin Atlantic Airways"
},
{
"airlineCode": "9W",
"flightNumber": "7592",
"airline": "Jet Airways"
}
]
}
],
"success": true
}
NOTE: Fields not available in the response will be omitted
Errors
Description | Payload |
---|---|
Response Code:400 Reason: url too long |
|
Response Code:404 Reason: No Flight Data |
|
Response Code:404 Reason: Airport not Found |
|
Response Code:404 Reason: Airline not Found |
|
Response Code:404 Reason:No Service Available |
|
Response Code:400 Reason:status updates requested but no endpoint provided |
|