Request Flight Update History

Format

Method Request

GET


https://{host}/flifo/v3/flights/updates

GET


https://{host}/flifo/v3/flights/updates/{airportCode}

GET


https://{host}/flifo/v3/flights/updates/{airportCode}/{airlineCode}

Parameters

Parameter Type Description Required
from Query Date (UTC) representing begin of interval to search. ISO8601 format Yes
to Query Date (UTC) representing begin of interval to search. ISO8601 format Yes
includeUpdates Query Type of result payload [true/false]
  • true: Retrieve a list with all updates. Showing name of updated field with previous and current (new) value;
  • false: Retrieve last version of Flight Record information, but do not list previous updates.
  • Yes
    groupUpdates Query Define is result will group all UPDATE for a single flight or not - Default true No
    callback Query name of callback function (JSONP) No

    Description

    The Flight Update History api returns information about updates on flights that happen in a time interval. Are available, three search possibilities and also customer has the option to choose the response message format.

    Payload Example

    Request

    https://{host}/flifo/v3/flights/updates?from=2016-03-28T06:30:00-0600&to=2016-03-28T17:30:00-0600&includeUpdates=true&groupUpdates=true

    Response

    
    
    {
      "success": true,
      "interval": {
        "from": "2016-03-28T00:30:00+0000",
        "to": "2016-03-28T17:02:42+0000"
      },
      "groupUpdates": true,
      "includeUpdates": true,
      "matchedRecords": 2,
      "records": [
        {
          "flightKey": "2016-03-28_JFK_DL_479_A",
          "airportCode": "JFK",
          "city": "New York",
          "adi": "ARRIVAL",
          "flightRecord": {
            "operatingCarrier": {
              "airlineCode": "DL",
              "airline": "Delta Air Lines",
              "flightNumber": "479"
            },
            "airportCode": "BCN",
            "scheduled": "2016-03-28T16:46:00-0400",
            "estimated": "2016-03-28T17:03:00-0400",
            "aircraft": "A333",
            "city": "BARCELONA",
            "terminal": "1",
            "gate": "B1",
            "status": "DP",
            "statusText": "Departed"
          },
          "update": [
            {
              "updatedField": "GATE",
              "previous": "B41",
              "current": "B1",
              "received": "2016-03-28T20:45:07+0000"
            },
            {
              "updatedField": "TERMINAL",
              "previous": "4",
              "current": "1",
              "received": "2016-03-28T20:45:20+0000"
            }
          ],
          "version": 3
        }
      ]
    }
      

    Errors

    Description Payload
    Response code:400
    Reason:
  • Param TO after current time;

  • Param FROM before pre determined period (24 hours)

  • Param FROM after TO

  • 
    {
      "errors": {
        "error": [
          {
            "description": "Invalid period of dates",
            "code": 2031
          }
        ]
      },
      "success": false,
      "grouped": false
    }
    
    
    Response code:400
    Reason:Invalid date format
    
    {
      "errors": {
        "error": [
          {
            "description": "Illegal date format",
            "code": 2032
          }
        ]
      },
      "success": false,
      "grouped": false
    }
    
    
    Response code:400
    Reason:Difference between FROM and TO param bigger than 60 mins;
    
    {
      "success": false,
      "groupUpdates": false,
      "includeUpdates": false,
      "matchedRecords": 0,
      "errors": {
        "error": [
          {
            "description": "Search interval exceeds the max value of 60 minutes",
            "code": 2034
          }
        ],
        "statusCode": 400
      }
    }