Request Status Update API

The Notifications API is called to explicitly subscribe to receive flight status updates. 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/notifications/{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
notifyEndpoint Endoint where updates are to be delivered. Yes
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/notifications/lax/dl/2355/a?notifyEndpoint=my.endpoint.com/flifo

Response


{
    "airportCode": "lax",
    "airlineCode": "dl",
    "flightNumber": "2355",
    "flightDate": "2014-11-12T19:31:38.261Z",
    "adi": "a",
    "subscribedForUpdates": true,
    "success": true
}
  

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 Service Available

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

404 No Flight Exists

{
  "errors": {
     "error": [
       {
         "description": "flight does not exist",
         "code": "1005"
       }
      ]
   },
   "success": false
}

500 System Error

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