API Playground: Interactive Documentation

Test our API services using our API Playground (aka I/O Docs). You can also view our written documentation.

OAuth 2.0 Flow:

Existing Client Credentials:

API Key:

App/Key: Manually provide key information

Shared Secret:

Client ID:

Client Secret:

Client ID:

Client Secret:

Username:

Password:

Client ID:

Client Secret:

Authorization Code:

Access Token:

Username:

Password:

Username:

Binary Security Token:

Username:

Password:

Reference Data

List Methods

Expand Methods

GET Countries references/countries/{countryCode}

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

Parameter	Type	Description
{countryCode}	string	2-letter ISO 3166-1 country code
lang	string	2 letter ISO 3166-1 language code
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)
offset	string	Number of records skipped. Defaults to 0
Accept	string	http header: application/json or application/xml

GET Cities references/cities/{cityCode}

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

Parameter	Type	Description
{cityCode}	string	3-letter IATA city code
lang	string	2 letter ISO 3166-1 language code
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)
offset	string	Number of records skipped. Defaults to 0
Accept	string	http header: application/json or application/xml

GET Airports 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.

Parameter	Type	Description
{airportCode}	string	3-letter IATA airport code
lang	string	2-letter ISO 3166-1 language code
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)
offset	string	Number of records skipped. Defaults to 0
LHoperated	boolean	Restrict the results to locations with flights operated by LH (false=0, true=1)
Accept	string	http header: application/json or application/xml

GET Nearest Airports references/airports/nearest/{latitude},{longitude}

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

Parameter	Type	Description
{latitude}	number	Latitude in decimal format to at most 3 decimal places
{longitude}	number	Longitude in decimal format to at most 3 decimal places
lang	string	2 letter ISO 3166-1 language code
Accept	string	http header: application/json or application/xml

GET Airlines references/airlines/{airlineCode}

List all airlines or one specific airline.

Parameter	Type	Description
{airlineCode}	string	2-character IATA airline/carrier code
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)
offset	string	Number of records skipped. Defaults to 0
Accept	string	http header: application/json or application/xml

GET Aircraft references/aircraft/{aircraftCode}

List all aircraft types or one specific aircraft type.

Parameter	Type	Description
{aircraftCode}	string	3-character IATA aircraft code
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)
offset	string	Number of records skipped. Defaults to 0
Accept	string	http header: application/json or application/xml

Offers

List Methods

Expand Methods

GET Seat Maps offers/seatmaps/{flightNumber}/{origin}/{destination}/{date}/{cabinClass}

Cabin layout and seat characteristics.

Parameter	Type	Description
{flightNumber}	string	Flight number including carrier code and any suffix (e.g. 'LH2037')
{origin}	string	Departure airport. 3-letter IATA airport code (e.g. 'TXL')
{destination}	string	Destination airport. 3-letter IATA airport code (e.g. 'MUC')
{date}	date	Departure date (YYYY-MM-DD)
{cabinClass}	string	Cabin class: 'M', 'E', 'C', 'F'. Some flights have fewer classes
Accept	string	http header: application/json or application/xml

GET Lounges offers/lounges/{location}

Lounge information

Parameter	Type	Description
{location}	string	3-leter IATA airport or city code (e.g. 'ZRH')
cabinClass	string	Cabin class: 'M', 'E', 'C', 'F'
tierCode	string	Frequent flyer level ('FTL', 'SGC', 'SEN', 'HON')
lang	string	Language code.
Accept	string	http header: application/json or application/xml

Operations

List Methods

Expand Methods

GET Flight Status operations/flightstatus/{flightNumber}/{date}

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

Parameter	Type	Description
{flightNumber}	string	Flight number including carrier code and any suffix (e.g. 'LH400')
{date}	date	The departure date (YYYY-MM-DD) in the local time of the departure airport
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)
offset	string	Number of records skipped. Defaults to 0
Accept	string	http header: application/json or application/xml

GET Flight Status by Route operations/flightstatus/route/{origin}/{destination}/{date}

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

Parameter	Type	Description
{origin}	string	3-letter IATA airport (e.g. 'FRA')
{destination}	string	3-letter IATA airport code (e.g. 'JFK')
{date}	string	Departure date (YYYY-MM-DD) in local time of departure airport
serviceType	string	serviceType to retrieve cargo, paasenger or both flights. for example: all or Passenger or Cargo.( default : Passenger)
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)
offset	string	Number of records skipped. Defaults to 0
Accept	string	http header: application/json or application/xml

GET Flight Status at Arrival Airport operations/flightstatus/arrivals/{airportCode}/{fromDateTime}

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

Parameter	Type	Description
{airportCode}	string	3-letter IATA aiport code (e.g. 'ZRH')
{fromDateTime}	string	Start of time range in local time of arrival airport (YYYY-MM-DDTHH:mm)
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)
offset	string	Number of records skipped. Defaults to 0
Accept	string	http header: application/json or application/xml

GET Flight Status at Departure Airport operations/flightstatus/departures/{airportCode}/{fromDateTime}

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

Parameter	Type	Description
{airportCode}	string	Departure airport. 3-letter IATA airport code (e.g. 'HAM')
{fromDateTime}	string	Start of time range in local time of departure airport (YYYY-MM-DDTHH:mm)
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)
offset	string	Number of records skipped. Defaults to 0
Accept	string	http header: application/json or application/xml

GET Flight Schedules operations/schedules/{origin}/{destination}/{fromDateTime}

Scheduled flights between given airports on a given date.

Parameter	Type	Description
{origin}	string	Departure airport. 3-letter IATA airport code (e.g. 'ZRH')
{destination}	string	Destination airport. 3-letter IATA airport code (e.g. 'FRA')
{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
directFlights	boolean	Show only direct flights (false=0, true=1). Default is false
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)
offset	string	Number of records skipped. Defaults to 0
Accept	string	http header: application/json or application/xml

Cargo

List Methods

Expand Methods

GET Shipment Tracking cargo/shipmentTracking/{aWBPrefix}-{aWBNumber}

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

Parameter	Type	Description
{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
{aWBNumber}	string	aWBNumber : The Air Waybill Number , format : [0-9]{8} e.g. 08002050
Accept	string	http header: application/json or application/xml

GET Retrieve all flights 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.

Parameter	Type	Description
{origin}	string	Departure Airport : 3-letter IATA airport code, e.g. FRA.
{destination}	string	Arrival airport : 3-letter IATA airport code, e.g. HKG.
{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
{productCode}	string	Product code for requested service and specials : 3-letter eg: YNZ
Accept	string	http header: application/json or application/xml

API Playground: Interactive Documentation

Select an API LH Public API

Reference Data List Methods Expand Methods

Offers List Methods Expand Methods

Operations List Methods Expand Methods

Cargo List Methods Expand Methods

Contact us here for any information or if you are missing something!

Reference Data

List Methods

Expand Methods

Offers

List Methods

Expand Methods

Operations

List Methods

Expand Methods

Cargo

List Methods

Expand Methods