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

Path Parameters

Request Query Parameters

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

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

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

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

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

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

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

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

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