Lufthansa - API LH Public

Lufthansa / LH Public

LH Public

transport

License: LH

Resources

Cargo

GET

/cargo/getRoute/{origin}-{destination}/{fromDate}/{productCode}

Retrieve a list of all possible flights (both direct and connecting) between two airports on a given date. Routes are available for today and up to days in the future.

Request

Path

Name	Data Type	Description
`productCode`	string Allowed values: - `FAN` - `FCO` - `FCP` - `FDG` - `FTF` - `FUN` - `FWN` - `YCO` - `YCP` - `YDG` - `YNB` - `YNZ` - `YTF` - `YUN` - `ZXB` - `ZXF` - `ZXR`	Product code for requested service and specials : 3-letter eg: YNZ
`fromDate`	string	Departure date in the local time of the departure airport. Based on LAT (Latest Acceptance Time). format : yyyy-MM-dd eg : 2017-07-15
`destination`	string	Arrival airport : 3-letter IATA airport code, e.g. HKG.
`origin`	string	Departure Airport : 3-letter IATA airport code, e.g. FRA.

Header

Name	Data Type	Description
`Accept`	string	http header: application/json or application/xml (Acceptable values are: "application/json", "application/xml")

Responses

200OK

Body

Name	Data Type	Description
`body`	object

GET

/cargo/shipmentTracking/{aWBPrefix}-{aWBNumber}

With this tracking service you can easily retrieve your shipment or flight status information.

Request

Path

Name	Data Type	Description
`aWBNumber`	string	aWBNumber : The Air Waybill Number , format : [0-9]{8} e.g. 08002050
`aWBPrefix`	string	aWBPrefix : Represents the airline that is the owner of this AWB, i.e. "020" = Lufthansa Cargo, format : [0-9]{3} e.g. 020

Header

Name	Data Type	Description
`Accept`	string	http header: application/json or application/xml (Acceptable values are: "application/json", "application/xml")

Responses

200OK

Body

Name	Data Type	Description
`body`	object

Offers

GET

/offers/lounges/{location}

Lounge information

Request

Path

Name	Data Type	Description
`location`	string	3-leter IATA airport or city code (e.g. 'ZRH')

Query

Name	Data Type	Description
`lang`	string	Language code.
`tierCode`	string	Frequent flyer level ('FTL', 'SGC', 'SEN', 'HON') (Acceptable values are: "", "FTL", "SGC", "SEN", "HON")
`cabinClass`	string	Cabin class: 'M', 'E', 'C', 'F' (Acceptable values are: "", "M", "E", "C", "F")

Header

Name	Data Type	Description
`Accept`	string	http header: application/json or application/xml (Acceptable values are: "application/json", "application/xml")

Responses

200OK

Body

Name	Data Type	Description
`body`	object

GET

/offers/seatmaps/{flightNumber}/{origin}/{destination}/{date}/{cabinClass}

Cabin layout and seat characteristics.

Request

Path

Name	Data Type	Description
`cabinClass`	string	Cabin class: 'M', 'E', 'C', 'F'. Some flights have fewer classes (Acceptable values are: "M", "E", "C", "F")
`date`	string	Departure date (YYYY-MM-DD)
`destination`	string	Destination airport. 3-letter IATA airport code (e.g. 'MUC')
`origin`	string	Departure airport. 3-letter IATA airport code (e.g. 'TXL')
`flightNumber`	string	Flight number including carrier code and any suffix (e.g. 'LH2037')

Header

Name	Data Type	Description
`Accept`	string	http header: application/json or application/xml (Acceptable values are: "application/json", "application/xml")

Responses

200OK

Body

Name	Data Type	Description
`body`	object

Operations

GET

/operations/flightstatus/arrivals/{airportCode}/{fromDateTime}

Status of all arrivals at a given airport up to 4 hours from the provided date time.

Request

Path

Name	Data Type	Description
`fromDateTime`	string	Start of time range in local time of arrival airport (YYYY-MM-DDTHH:mm)
`airportCode`	string	3-letter IATA aiport code (e.g. 'ZRH')

Query

Name	Data Type	Description
`offset`	string	Number of records skipped. Defaults to 0
`limit`	string	Number of records returned per request. Defaults to 20, maximum is 100 (if a value bigger than 100 is given, 100 will be taken)

Header

Name	Data Type	Description
`Accept`	string	http header: application/json or application/xml (Acceptable values are: "application/json", "application/xml")

Responses

200OK

Body

Name	Data Type	Description
`body`	object

GET

/operations/flightstatus/departures/{airportCode}/{fromDateTime}

Status of all departures from a given airport up to 4 hours from the provided date time.

Request

Path

Name	Data Type	Description
`fromDateTime`	string	Start of time range in local time of departure airport (YYYY-MM-DDTHH:mm)
`airportCode`	string	Departure airport. 3-letter IATA airport code (e.g. 'HAM')

Query

Name	Data Type	Description
`offset`	string	Number of records skipped. Defaults to 0
`limit`	string	Number of records returned per request. Defaults to 20, maximum is 100 (if a value bigger than 100 is given, 100 will be taken)

Header

Name	Data Type	Description
`Accept`	string	http header: application/json or application/xml (Acceptable values are: "application/json", "application/xml")

Responses

200OK

Body

Name	Data Type	Description
`body`	object

GET

/operations/flightstatus/route/{origin}/{destination}/{date}

Status of flights between a given origin and destination on a given date.

Request

Path

Name	Data Type	Description
`date`	string	Departure date (YYYY-MM-DD) in local time of departure airport
`destination`	string	3-letter IATA airport code (e.g. 'JFK')
`origin`	string	3-letter IATA airport (e.g. 'FRA')

Query

Name	Data Type	Description
`offset`	string	Number of records skipped. Defaults to 0
`limit`	string	Number of records returned per request. Defaults to 20, maximum is 100 (if a value bigger than 100 is given, 100 will be taken)

Header

Name	Data Type	Description
`Accept`	string	http header: application/json or application/xml (Acceptable values are: "application/json", "application/xml")

Responses

200OK

Body

Name	Data Type	Description
`body`	object

GET

/operations/flightstatus/{flightNumber}/{date}

Status of a particular flight (boarding, delayed, etc.).

Request

Path

Name	Data Type	Description
`date`	string	The departure date (YYYY-MM-DD) in the local time of the departure airport
`flightNumber`	string	Flight number including carrier code and any suffix (e.g. 'LH400')

Query

Name	Data Type	Description
`offset`	string	Number of records skipped. Defaults to 0
`limit`	string	Number of records returned per request. Defaults to 20, maximum is 100 (if a value bigger than 100 is given, 100 will be taken)

Header

Name	Data Type	Description
`Accept`	string	http header: application/json or application/xml (Acceptable values are: "application/json", "application/xml")

Responses

200OK

Body

Name	Data Type	Description
`body`	object

GET

/operations/schedules/{origin}/{destination}/{fromDateTime}

Scheduled flights between given airports on a given date.

Request

Path

Name	Data Type	Description
`fromDateTime`	string	Local departure date and optionally departure time (YYYY-MM-DD or YYYY-MM-DDTHH:mm). When not provided, time is assumed to be 00:01
`destination`	string	Destination airport. 3-letter IATA airport code (e.g. 'FRA')
`origin`	string	Departure airport. 3-letter IATA airport code (e.g. 'ZRH')

Query

Name	Data Type	Description
`offset`	string	Number of records skipped. Defaults to 0
`limit`	string	Number of records returned per request. Defaults to 20, maximum is 100 (if a value bigger than 100 is given, 100 will be taken)
`directFlights`	boolean	Show only direct flights (false=0, true=1). Default is false

Header

Name	Data Type	Description
`Accept`	string	http header: application/json or application/xml (Acceptable values are: "application/json", "application/xml")

Responses

200OK

Body

Name	Data Type	Description
`body`	object

Reference Data

GET

/references/aircraft/{aircraftCode}

List all aircraft types or one specific aircraft type.

Request

Path

Name	Data Type	Description
`aircraftCode`	string Default value: `33P`	3-character IATA aircraft code

Query

Name	Data Type	Description
`offset`	string Default value: `0`	Number of records skipped. Defaults to 0
`limit`	string Default value: `20`	Number of records returned per request. Defaults to 20, maximum is 100 (if a value bigger than 100 is given, 100 will be taken)

Header

Name	Data Type	Description
`Accept`	string	http header: application/json or application/xml (Acceptable values are: "application/json", "application/xml")

Responses

200OK

Body

Name	Data Type	Description
`body`	object

GET

/references/airlines/{airlineCode}

List all airlines or one specific airline.

Request

Path

Name	Data Type	Description
`airlineCode`	string Default value: `LH`	2-character IATA airline/carrier code

Query

Name	Data Type	Description
`offset`	string Default value: `0`	Number of records skipped. Defaults to 0
`limit`	string Default value: `20`	Number of records returned per request. Defaults to 20, maximum is 100 (if a value bigger than 100 is given, 100 will be taken)

Header

Name	Data Type	Description
`Accept`	string	http header: application/json or application/xml (Acceptable values are: "application/json", "application/xml")

Responses

200OK

Body

Name	Data Type	Description
`body`	object

GET

/references/airports/nearest/{latitude},{longitude}

List the 5 closest airports to the given latitude and longitude, irrespective of the radius of the reference point.

Request

Path

Name	Data Type	Description
`longitude`	integer	Longitude in decimal format to at most 3 decimal places
`latitude`	integer	Latitude in decimal format to at most 3 decimal places

Query

Name	Data Type	Description
`lang`	string	2 letter ISO 3166-1 language code

Header

Name	Data Type	Description
`Accept`	string	http header: application/json or application/xml (Acceptable values are: "application/json", "application/xml")

Responses

200OK

Body

Name	Data Type	Description
`body`	object

GET

/references/airports/{airportCode}

List all airports or one specific airport. All airports response is very large. It is possible to request the response in a specific language.

Request

Path

Name	Data Type	Description
`airportCode`	string Default value: `TXL`	3-letter IATA airport code

Query

Name	Data Type	Description
`LHoperated`	boolean	Restrict the results to locations with flights operated by LH (false=0, true=1)
`offset`	string Default value: `0`	Number of records skipped. Defaults to 0
`limit`	string Default value: `20`	Number of records returned per request. Defaults to 20, maximum is 100 (if a value bigger than 100 is given, 100 will be taken)
`lang`	string	2-letter ISO 3166-1 language code

Header

Name	Data Type	Description
`Accept`	string	http header: application/json or application/xml (Acceptable values are: "application/json", "application/xml")

Responses

200OK

Body

Name	Data Type	Description
`AirportResponse`	object

Properties

AirportResource AirportResource


                        AirportResource

object

Root element of airport response.

Properties

`Meta`
`Airports`

GET

/references/cities/{cityCode}

List all cities or one specific city. It is possible to request the response in a specific language.

Request

Path

Name	Data Type	Description
`cityCode`	string Default value: `BER`	3-letter IATA city code

Query

Name	Data Type	Description
`offset`	string Default value: `0`	Number of records skipped. Defaults to 0
`limit`	string Default value: `20`	Number of records returned per request. Defaults to 20, maximum is 100 (if a value bigger than 100 is given, 100 will be taken)
`lang`	string	2 letter ISO 3166-1 language code

Header

Name	Data Type	Description
`Accept`	string	http header: application/json or application/xml (Acceptable values are: "application/json", "application/xml")

Responses

200OK

Body

Name	Data Type	Description
`body`	object

GET

/references/countries/{countryCode}

List all countries or one specific country. It is possible to request the response in a specific language.

Request

Path

Name	Data Type	Description
`countryCode`	string Default value: `DK`	2-letter ISO 3166-1 country code

Query

Name	Data Type	Description
`offset`	string Default value: `0`	Number of records skipped. Defaults to 0
`limit`	string Default value: `20`	Number of records returned per request. Defaults to 20, maximum is 100 (if a value bigger than 100 is given, 100 will be taken)
`lang`	string	2 letter ISO 3166-1 language code

Header

Name	Data Type	Description
`Accept`	string	http header: application/json or application/xml (Acceptable values are: "application/json", "application/xml")

Responses

200OK

Body

Name	Data Type	Description
`body`	object

Models

Airport

Array of all available airports or one airport matching the request.

Properties

Name	Data Type	Description
`UtcOffset`	float	Hour offset of airport to UTC time zone
`TimeZoneId`	string	Time zone name airport is in
`Position`
`Names`
`LocationType`	string	“Airport”, “RailwayStation” or “BusStation”.
`CountryCode`	string	2-letter ISO 3166-1 country code, e.g. “DE”.
`CityCode`	string	3-letter IATA city code, e.g. “BER”.
`AirportCode`	string	3-letter IATA airport code, e.g. “TXL”.

AirportResource

AirportResponse

Coordinate

Link

Name

Authentication

Oauth2

'OAuth' Authentication Scheme
Reference: RFC5849, Section 3.5.1

Flow: authorizationCode
Authorization URL: https://api.lufthansa.com/v1/oauth/token
Token URL: https://api.lufthansa.com/v1/oauth/token
Scopes:

read:LH Open API: read access

Metadata (Technical Details)

Origin - Format	`swagger`
Origin - Url	`https://raw.githubusercontent.com/LufthansaOpenAPI/Swagger/master/LH_public_API_swagger_2_0.json`
Origin - Version	`2.0`
Provider Name	`lufthansa.com`
Service Name	`public`
API Version	`1.0`

Comments

Loading comments ...