GET /flightstatus/[id]

GET /flightstatus/[id]

This endpoint retrieves one specific operational flight information. The specific flight is identified by the resource path variable [id]. Trajectory information can be requested via expand parameter.

Request

GET

/flights/[id]

url

key

Explanation

Example

Mandatory

[id]

Identification of a specific flight with format: yyyyMMdd+carrierCode+flightNumber+operationalSuffix

20171231+KL+0641

Yes

headers

key

value

Mandatory/Optional Use

Accept

application/hal+json;version=com.afkl.operationalflight.v3

Accept-Language <<language code>> . e.g nl Optional

To request flight (leg) status translation in different language.

At a time translation is possible in one language.

parameters

key

Explanation

Example

Mandatory

origin

Departure airport

AMS

No

expand

Request trajectory information, currently only supports value: trajectory

trajectory

No

Examples

Request urls

 

request with all parameters used
/flights/20160914+KL+0641+D?expand=Trajectory
 
request for normal flight
/flights/20160914+KL+0641
 
request for flight with operational suffix in id
/flights/20160914+KL+0641+D
 
request for normal flight with trajectory information
/flights/20160914+KL+0641?expand=Trajectory

 

 Response

 

{
  "flightNumber": 603,
  "id": "20170829+KL+1975",
  "haul": "MEDIUM",
  "route": [
    "AMS",
    "BUD"
  ],
  "airline": {
    "code": "KL"
  },
 "codeShareRelations": [
    {
      "marketingFlightNumber": 9695,
      "type": "PASSENGER",
      "airline": {
        "code": "DL"
      }
    },
    {
      "marketingFlightNumber": 9629,
      "type": "PASSENGER",
      "airline": {
        "code": "MF"
      }
    }
  ],
  "flightLegs": [
    {
      "_links": {},
      "status": "S",
      "statusName": "Scheduled",
      "publishedStatus": "INTRANSIT",
      "departureInformation": {
        "airport": {
          "code": "AMS",
          "name": "SCHIPHOL AIRPORT",
          "places": {
            "gateNumber": [
              "C05"
            ],
            "parkingPosition": "C05",
            "pierCode": "C",
            "boardingPier": "C",
            "checkInZone": [
              "01"
            ]
          }
        },
        "times": {
          "scheduled": "2017-08-29T11:20:00.000+02:00",
          "latestPublished": "2017-08-29T11:19:00.000+02:00"
        }
      },
      "arrivalInformation": {
        "airport": {
          "code": "BUD",
          "name": "LISZT FERENC INTERNATIONAL AIRPORT",
          },
        },
        "times": {
          "scheduled": "2017-08-29T13:15:00.000+02:00",
          "latestPublished": "2017-08-29T13:15:00.000+02:00"
        }
      },
      "scheduledFlightDuration": "PT1H55M",
      "departureDateTimeDifference": "PT-1M",
      "aircraft": {
      "registration": "PHBGW",
        "typeCode": "73W",
        "typeName": "Boeing 737-700"
      }
    }
  ]
}

 

Specification of the reponse

OFR Response

OFR Error Response

Docs Navigation