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
}