Landing Report

Summary

Landing report for a logged-in crew member.

Request

Code snippet: URL

GET /v1/flight_operations/crew_services/COMMON_LANDING_REPORT

Parameters

Name Type Description Required Schema / Format
flightDesignator Query

IATA flight designator consists of airline code, flight number and suffix (optional).

The flight number must consist of at least 3 digits, zero-padded for numbers less than 100, e.g. LH001, LH023, LH100, LH1376.

yes

xsd:string

([0-9][A-Z]|[A-Z][0-9]|[A-Z]{2})([0-9]{3,4})([A-Z]?)

flightDate Query Flight date of operation, date of first leg of a flight in UTC, format "YYYY-MM-DDZ" yes

xsd:date

[0-9]{4}[-][0-9]{2}[-][0-9]{2}Z

YYYY-MM-DDZ

departureAirport Query Departure airport IATA code. yes

xsd:string

[A-Z]{3}

Responses

Code Description Content-Type Schema
200 Landing Report successfully generated. application/json Landing Report Model
404 The requested flight has not been found. application/json Processing Errors Model
500 Any other error application/json Processing Errors Model

Landing Report

Code snippet: Payload

{
    "pkNumber" → xsd:string
    "flightDesignator" → xsd:string
    "flightDate" → xsd:date
    "departureAirport" → xsd:string
    "destinationAirport" → xsd:string

    "tailsign" → xsd:string

    "events" → {
        "aircraft" → {
            "out" → xsd:dateTime
            "off" → xsd:dateTime
            "on" → xsd:dateTime
            "in" → xsd:dateTime
        }
        "opsData" → {
            "out" → xsd:dateTime
            "off" → xsd:dateTime
        }
        "flightLog" → {
            "out" → xsd:dateTime
            "in" → xsd:dateTime
        }
    }

    "landingPerformed" → xsd:boolean | "unknown"
    "lowVisibilityApproach" → xsd:boolean | "unknown"
}
Name Description Required Schema / Format
pkNumber Staff identifier (German: Personalkennziffer) of the person requesting the landing report. yes

xsd:string

[0-9]{6}[A-Z]

flightDesignator IATA flight designator consists of airline code, flight number and suffix (optional). yes

xsd:string

[A-Z0-9]{2}[0-9]{1,4}[A-Z]?

flightDate Flight date of operation, date of first leg of a flight in UTC. yes

xsd:date

[0-9]{4}[-][0-9]{2}[-][0-9]{2}Z

YYYY-MM-DDZ

departureAirport Departure airport IATA code. yes

xsd:string

[A-Z]{3}

destinationAirport Arrival airport IATA code. yes

xsd:string

[A-Z]{3}

tailsign Registration of the aircraft. yes

xsd:string

[A-Z0-9]{5}

for Lufthansa Germany:

D[A-Z]{4}

events Time events related to the flight. yes
events → aircraft Time events coming automatically from the aircraft (e.g. via DataLink). yes
events → aircraft → out OUT event (leaving the park position/terminal).

xsd:dateTime

[0-9]{4}[-][0-9]{2}[-][0-9]{2}T[0-9]{2}[:][0-9]{2}[:][0-9]{2}Z

YYYY-MM-DDTHH:MM:SSZ

events → aircraft → off OFF event (take off).

xsd:dateTime

[0-9]{4}[-][0-9]{2}[-][0-9]{2}T[0-9]{2}[:][0-9]{2}[:][0-9]{2}Z

YYYY-MM-DDTHH:MM:SSZ

events → aircraft → on ON event (touch down).

xsd:dateTime

[0-9]{4}[-][0-9]{2}[-][0-9]{2}T[0-9]{2}[:][0-9]{2}[:][0-9]{2}Z

YYYY-MM-DDTHH:MM:SSZ

events → aircraft → in IN event (park position/terminal).

xsd:dateTime

[0-9]{4}[-][0-9]{2}[-][0-9]{2}T[0-9]{2}[:][0-9]{2}[:][0-9]{2}Z

YYYY-MM-DDTHH:MM:SSZ

events → opsData Time events coming from the ops data system (LH TANGO) yes
events → opsData→ out OUT event (leaving the park position/terminal).

xsd:dateTime

[0-9]{4}[-][0-9]{2}[-][0-9]{2}T[0-9]{2}[:][0-9]{2}[:][0-9]{2}Z

YYYY-MM-DDTHH:MM:SSZ

events → opsData→ off OFF event (take off).

xsd:dateTime

[0-9]{4}[-][0-9]{2}[-][0-9]{2}T[0-9]{2}[:][0-9]{2}[:][0-9]{2}Z

YYYY-MM-DDTHH:MM:SSZ

events → flightLog Time events coming from the flight log as reported by the pilots. yes
events → flightLog→ out OUT event (leaving the park position/terminal).

xsd:dateTime

[0-9]{4}[-][0-9]{2}[-][0-9]{2}T[0-9]{2}[:][0-9]{2}[:][0-9]{2}Z

YYYY-MM-DDTHH:MM:SSZ

events → flightLog→ in IN event (park position/terminal).

xsd:dateTime

[0-9]{4}[-][0-9]{2}[-][0-9]{2}T[0-9]{2}[:][0-9]{2}[:][0-9]{2}Z

YYYY-MM-DDTHH:MM:SSZ

landingPerformed

A flag denoting if the person requesting the landing report has performed the landing.

The "unknown" value denotes no data in the respective backend system.

yes

xsd:boolean

or

xsd:string = "unknown"

lowVisibilityApproach

A flag denoting if the approach has been performed in low visibility conditions.

The "unknown" value denotes no data in the respective backend system.

yes

xsd:boolean

or

xsd:string = "unknown"

Example

Request

Code snippet: URL
GET /v1/flight_operations/crew_services/COMMON_LANDING_REPORT?flightDesignator=LH400&flightDate=2017-02-10Z&departureAirport=FRA

Response

Code snippet: Payload
{
    "pkNumber": "440251K",
    "flightDesignator": "LH400",
    "flightDate": "2017-02-10Z",
    "departureAirport": "FRA",
    "destinationAirport": "JFK",
  
    "tailsign": "DABYC",
  
    "events": {
        "aircraft": {
            "out": "2017-02-10T10:04:00Z",
            "off": "2017-02-10T10:24:00Z",
            "on": "2017-02-10T18:34:00Z",
            "in": "2017-02-10T18:47:00Z"
        },
        "tango": {
            "out": "2017-02-10T09:55:00Z",
            "off": "2017-02-10T10:22:00Z"
        },
        "flightLog": {
            "out": "2017-02-10T09:50:00Z",
            "in": "2017-02-10T18:40:00Z"
        }
    },

    "landingPerformed": "true",
    "lowVisibilityApproach": "unknown"
}