LH OpenAPI testing

OAuth 2.0 Flow: Select OAuth 2.0 Flow

Existing Client Credentials: Manual Input

API Key:

App/Key: Select Application Key Manually provide key information

Shared Secret:

Client ID:

Client Secret: Authorize

Client ID: Get Access Token

Client ID:

Client Secret:

---

Username:

Password: Get Access Token

Client ID:

Client Secret: Get Access Token

Authorization Code: Get Access Token

Access Token:

Username:

Password:

Username:

Binary Security Token:

Username:

Password:

• Reference Data

  • List Methods
  • Expand Methods

  • GET Countries v1/mds-references/countries/{countryCode}

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

    Parameter	Value	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	application/json application/xml	string	http header: application/json or application/xml

  • GET Cities v1/mds-references/cities/{cityCode}

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

    Parameter	Value	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	application/json application/xml	string	http header: application/json or application/xml

  • GET Airports v1/mds-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	Value	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	True False	boolean	Restrict the results to locations with flights operated by LH (false=0, true=1)
    Accept	application/json application/xml	string	http header: application/json or application/xml

  • GET Nearest Airports v1/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	Value	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	application/json application/xml	string	http header: application/json or application/xml

  • GET Airlines v1/mds-references/airlines/{airlineCode}

    List all airlines or one specific airline.

    Parameter	Value	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	application/json application/xml	string	http header: application/json or application/xml

  • GET Aircraft v1/mds-references/aircraft/{aircraftCode}

    List all aircraft types or one specific aircraft type.

    Parameter	Value	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	application/json application/xml	string	http header: application/json or application/xml

• Offers

  • List Methods
  • Expand Methods

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

    Cabin layout and seat characteristics.

    Parameter	Value	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}	economy premium economy business first	string	Cabin class: 'M', 'E', 'C', 'F'. Some flights have fewer classes
    Accept	application/json application/xml	string	http header: application/json or application/xml

  • GET Lounges v1/offers/lounges/{location}

    Lounge information

    Parameter	Value	Type	Description
    {location}		string	3-leter IATA airport or city code (e.g. 'ZRH')
    cabinClass	economy premium economy business first	string	Cabin class: 'M', 'E', 'C', 'F'
    tierCode	frequent traveller star alliance gold senator HON circle member	string	Frequent flyer level ('FTL', 'SGC', 'SEN', 'HON')
    lang		string	Language code.
    Accept	application/json application/xml	string	http header: application/json or application/xml

• Operations

  • List Methods
  • Expand Methods

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

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

    Parameter	Value	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	application/json application/xml	string	http header: application/json or application/xml

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

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

    Parameter	Value	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	passenger cargo all	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	application/json application/xml	string	http header: application/json or application/xml

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

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

    Parameter	Value	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)
    serviceType	passenger cargo all	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	application/json application/xml	string	http header: application/json or application/xml

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

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

    Parameter	Value	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)
    serviceType	passenger cargo all	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	application/json application/xml	string	http header: application/json or application/xml

  • GET Customer Flight Information v1/operations/customerflightinformation/{flightNumber}/{date}

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

    Parameter	Value	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	application/json application/xml	string	http header: application/json or application/xml

  • GET Customer Flight Information by Route v1/operations/customerflightinformation/route/{origin}/{destination}/{date}

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

    Parameter	Value	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
    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	application/json application/xml	string	http header: application/json or application/xml

  • GET Customer Flight Information at Arrival Airport v1/operations/customerflightinformation/arrivals/{airportCode}/{fromDateTime}

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

    Parameter	Value	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	application/json application/xml	string	http header: application/json or application/xml

  • GET Customer Flight Information at Departure Airport v1/operations/customerflightinformation/departures/{airportCode}/{fromDateTime}

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

    Parameter	Value	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	application/json application/xml	string	http header: application/json or application/xml

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

    Scheduled flights between given airports on a given date.

    Parameter	Value	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	True False	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	application/json application/xml	string	http header: application/json or application/xml

• Cargo

  • List Methods
  • Expand Methods

  • GET Shipment Tracking v2/cargo/shipment/tracking

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

    Parameter	Value	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	application/json	string	http header: application/json

  • GET Retrieve all flights v2/cargo/routes/get

    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	Value	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	Service: td.Flash, Special: Safe/td 1 Service: td.Flash, Special: Cool/td active Service: td.Flash, Special: Cool/td passive Service: td.Flash, Special: Care/td Service: td.Flash, Special: Fresh/td Service: td.Flash, Special: Safe/td 2 Service: td.Flash, Special: Live/td Service: td.Pro, Special: Cool/td active Service: td.Pro, Special: Cool/td passive Service: td.Pro, Special: Care/td Service: td.Pro, Special: BUP Service: td.Pro, Special: [none] Service: td.Pro, Special: Fresh/td Service: td.Pro, Special: Safe/td 2 Service: td.Flash, Special: BUP Service: td.Flash, Special: [none] Service: td.Flash, Special: Courier Solutions	string	Product code for requested service and specials : 3-letter eg: YNZ
    Accept	application/json application/xml	string	http header: application/json or application/xml