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.

 

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

{
  "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
}