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

Where flightNumber must be 4 digit in length

20171231+KL+0641

20190519+AF+0077

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.

 

Examples

Request urls

 

Curl Request:
 
curl https://api.airfranceklm.com/opendata/flightstatus/20190328+KL+1001 -H "accept-language:en-GB" -H "Api-Key:<userkeytoreplace>"

 

 Response

 

{ "flightNumber": 1001, "flightScheduleDate": "2019-03-28", "id": "20190328+KL+1001", "haul": "MEDIUM", "route": ["AMS", "LHR"], "airline": { "code": "KL", "name": "KLM ROYAL DUTCH AIRLINES" }, "codeShareRelations": [{ "marketingFlightNumber": 7679, "code": "F", "type": "PASSENGER", "airline": { "code": "CZ", "name": "CHINA SOUTHERN AIRLINES" } }, { "marketingFlightNumber": 9640, "code": "F", "type": "PASSENGER", "airline": { "code": "DL", "name": "DELTA AIR LINES INC." } }, { "marketingFlightNumber": 1001, "code": "F", "type": "PASSENGER", "airline": { "code": "KQ", "name": "KENYA AIRWAYS" } }, { "marketingFlightNumber": 9301, "code": "F", "type": "PASSENGER", "airline": { "code": "MF", "name": "XIAMEN AIRLINES" } }, { "marketingFlightNumber": 6992, "code": "F", "type": "PASSENGER", "airline": { "code": "VS", "name": "VIRGIN ATLANTIC AIRWAYS LIMITED" } }, { "marketingFlightNumber": 8995, "code": "F", "type": "PASSENGER", "airline": { "code": "9W", "name": "JET AIRWAYS (INDIA)  LIMITED" } }], "flightRelations": { "onwardFlightData": { "id": "20190328+KL+1002", "flightScheduleDate": "2019-03-28", "airlineCode": "KL", "flightNumber": "1002" } }, "flightStatusPublic": "ARRIVED", "flightStatusPublicLangTransl": "Aangekomen", "flightLegs": [{ "status": "S", "statusName": "Scheduled", "publishedStatus": "ARRIVED", "departureInformation": { "airport": { "code": "AMS", "name": "SCHIPHOL AIRPORT", "city": { "code": "AMS", "name": "AMSTERDAM", "country": { "areaCode": "N", "code": "NL", "name": "NETHERLANDS", "euroCountry": "Y", "euCountry": "Y" } }, "location": { "latitude": 52.3083, "longitude": 4.7681 }, "places": { "gateNumber": ["D52"], "parkingPosition": "D52", "pierCode": "D", "terminalCode": "02", "boardingPier": "D", "checkInZone": ["09", "10"], "boardingContactType": "C", "parkingPositionType": "C" } }, "times": { "actual": "2019-03-28T07:22:00.000+01:00", "scheduled": "2019-03-28T07:20:00.000+01:00", "modified": "2019-03-28T07:20:00.000+01:00", "latestPublished": "2019-03-28T07:22:00.000+01:00", "actualTakeOffTime": "2019-03-28T07:34:00.000+01:00" } }, "arrivalInformation": { "airport": { "code": "LHR", "name": "HEATHROW AIRPORT", "city": { "code": "LON", "name": "LONDON", "country": { "areaCode": "E", "code": "GB", "name": "UNITED KINGDOM", "euroCountry": "N", "euCountry": "Y" } }, "location": { "latitude": 51.4714, "longitude": -0.4528 }, "places": {  } }, "times": { "actual": "2019-03-28T07:23:00.000Z", "scheduled": "2019-03-28T07:40:00.000Z", "modified": "2019-03-28T07:40:00.000Z", "latestPublished": "2019-03-28T07:23:00.000Z", "estimated": { "value": "2019-03-28T07:23:00.000Z" }, "actualTouchDownTime": "2019-03-28T07:18:00.000Z" } }, "legStatusPublic": "ARRIVED", "legStatusPublicLangTransl": "Aangekomen", "passengerCustomsStatus": "NOT SCHENGEN", "serviceType": "J", "serviceTypeName": "Normal Service", "scheduledFlightDuration": "PT1H20M", "departureDateTimeDifference": "PT2M", "arrivalDateTimeDifference": "PT-17M", "timeToArrival": "PT0S", "completionPercentage": "100", "timeZoneDifference": "-0100", "aircraft": { "registration": "PHBXN", "typeCode": "73H", "typeName": "BOEING 737-800 (WINGLETS) PASSENGER", "subFleetCodeId": "F", "ownerAirlineCode": "KL", "ownerAirlineName": "KLM ROYAL DUTCH AIRLINES", "physicalPaxConfiguration": "C36M150", "physicalFreightConfiguration": "P000L000", "operationalConfiguration": "C16M162" }, "irregularity": { "cancelled": "N", "delayReasonCodePublic": ["FSR04"] }, "internalLegStatusArrFocus": false }], "internalStatusArrFocus": false}

 

Specification of the reponse

OFR Response

OFR Error Response

Docs Navigation