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

Method Request
GET https://host/flifo/v3/notifications/{airport}/{airline}/{flightNumber}/{adi}

Parameters

Parameter Type Description Required
airport Path The airport IATA code. Yes
airline Path The airline IATA code. No
flightNumber Path The flight Number Yes
adi Path Departure or arrival indicator(a/d) Yes
notifyEndpoint Query endoint where updates are to be delivered. Yes
operationDate Query Date of operation for the flight (default to current day) No
callback Query Name of callback function (JSONP). No

Description

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.

Payload Example

Request

https://flifo.api.aero/flifo/v3/notifications/lax/dl/2355/a?notifyEndpoint=my.endpoint.com/flifo

Response


{
    "airportCode": "LAX",
    "airlineCode": "DL",
    "flightNumber": "2355",
    "flightDate": "2018-11-20",
    "adi": "A",
    "subscribedForUpdates": true,
    "success": true
}
  

Errors

HTTP Code Description Payload
Response code:400
Reason:url too long

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

Response code:404
Reason:No Service Available

{
  "errors": {
     "error": [
       {
         "description": "no service available",
         "code": "1003"
       }
      ]
   },
   "success": false
}
Response code:404
Reason:No flight exists

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