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 (default to current day). No
callback Name of callback function (JSONP). No

Payload Example

Request

"https://host/flifo/v3/flight/lax/dl/2355/a?operationDate=2014-11-12&subscribeForUpdates=true¬ifyEndpoint=https://my.endpoint.com/updates

Response


{
    "airportCode": "lax",
    "airlineCode": "dl",
    "flightNumber": "2355",
    "flightDate": "2014-11-12",
    "adi": "a",
    "subscribedForUpdates": true,
    "flightRecord": [
        {
            "aircraft": "757",
     "claim":"8",
     “terminal”: “T”,
            "gate": "54B",
            "status": "ON",
            "statusText": "On Time",
            "operatingCarrier": {
                "airlineCode": "DL",
                "flightNumber": "2355",
                "airline": "Delta"
            },
            "scheduled": "2014-11-12T23:44:00",
            "estimated": "2014-11-12T23:44:00",
            "cityCode": "ATL",
            "city": "Atlanta",
            "tailNumber": "N676DL",
            "marketingCarriers": [
                {
                    "airlineCode": "AS",
                    "flightNumber": "5177",
                    "airline": "Alaska"
                }     
            ]
        }
    ],
    "success": true
}
  

NOTE: Fields not available in the response will be omitted

Errors

HTTP Code Reason Payload
400 Auth failed

{
 "errors":
   {"error":[
     {"description":"authentication failed",
       "code":"9998"
     }
   ]
  },
  "success":false
}
400 URL too long

{
 "errors": {
   "error": [
    {"description": "url too long. max length is 256",
     "code": 2027
    }
   ]
 },
 "success": false
}
404 No Flight Data

{
  "errors": {
     "error": [
        {
          "description": "No Flight Data",
          "code": "1001"
        }
     ]
    },
    "success": false
}

404 Airport not Found

{
  "errors": {
     "error": [
        {
          "description": airport not found",
          "code": "2020"
        }
     ]
    },
    "success": false
}

404 Airline not Found

{
  "errors": {
     "error": [
        {
          "description": airline not found",
          "code": "2019"
        }
     ]
    },
    "success": false
}

404 No Service Available

{
  "errors": {
     "error": [
       {
         "description": "no service available",
         "code": "1003"
       }
      ]
   },
   "success": false
}

400 Status updates requested but no endpoint provided

{
  "errors": {
     "error": [
       {
         "description": "notify requested but no endpoint defined",
         "code": "1004"
       }
      ]
   },
   "success": false
}

500 System Error

{
  "errors": {
     "error": [
       {
         "A system error occurred. Contact Support",
         "code": "9999"
       }
      ]
   },
   "success": false
}