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	`{ "errors": { "error": [ {"description": "url too long. max length is 256", "code": 2027 "notifyEndpoint": "ggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggg" } ] }, "success": false }`
Response Code:`404` Reason: No Flight Data	`{ "errors": { "error": [ { "description": "No Data available for this request", "code": "1001" } ] }, "success": false }`
Response Code:`404` Reason: Airport not Found	`{ "errors": { "error": [ { "description": “Airport not found", "code": "2020" "airportCode": "ZZZ" } ] }, "success": false }`
Response Code:`404` Reason: Airline not Found	`{ "errors": { "error": [ { "description": “Airline not found", "code": "2019" "airlineCode": "XS" } ] }, "success": false }`
Response Code:`404` Reason:No Service Available	`{ "errors": { "error": [ { "description": "No service available", "code": "1003" } ] }, "success": false }`
Response Code:`400` Reason:status updates requested but no endpoint provided	`{ "errors": { "error": [ { "description": "Notification Endpoint required", "code": "9999" "notifyEndpoint": null } ] }, "success": false }`

Flight Record API Flight-Information-API