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:

• offers

  • List Methods
  • Expand Methods

  • GET AllFares /offers/fares/allfares

    Retrieve all fares for Origin (LHR) & Destination (FRA) on possible date from today with sinlge adult (adult=1) or multi passenger with 2 adults, 1 child, 1 infant (adult=2;child=1;infant=1) & only economy cabin class

    Parameter	Value	Type	Description
    catalogues		string	airline code (e.g.'LH').
    origin		string	Enter journey origin airport code : supports only 'LHR'
    destination		string	Enter journey destination airport code : 'FRA'
    travel-date		string	Enter journey travel-date (e.g 2018-10-15)
    return-date		string	Enter journey return-date (e.g 2018-10-30)'.
    cabin-class	economy	string	Enter the required cabin class for ex: economy ( supported economy only)
    travelers		string	supports only single adult or 2 adults, 1 child, 1 infant = (e.g. '(adult=1)' or '(adult=2;child=2;infant=1)').
    Accept	application/json application/xml	string	Mandatory http header: application/xml or application/json

  • GET LowestFares /offers/fares/lowestfares

    Retrieve lowest fares for Origin (LHR) & Destination (FRA) on possible date from today with sinlge adult (adult=1) or multi passenger with 2 adults, 1 child, 1 infant (adult=2;child=1;infant=1) & only economy cabin class

    Parameter	Value	Type	Description
    catalogues		string	Search fares from these carriers' catalogues 'LH'
    origin		string	Journey origin. 3-letter IATA aiport code. Support only 'LHR'
    destination		string	Journey destination. 3-letter IATA airport code. Support only 'FRA'
    travel-date		string	Journey travel-date YYYY-MM-DD for ex: 2018-10-15
    return-date		string	Journey return-date format: YYYY-MM-DD for ex:2018-10-30
    cabin-class	economy	string	Cabin class: 'economy'
    travelers		string	Type and number of travelers e.g. supported '(adult=1)' or '(adult=2;child=2;infant=1)'
    Accept	application/json application/xml	string	http header: application/json or application/xml

• paymentToken

  • List Methods
  • Expand Methods

  • POST payment Token /sales/bookings/token

    generate payment token for pnrlesspricing second call & booking request - use any dummy card with visa or master

    Parameter	Value	Type	Description
    Accept	application/x-www-form-urlencoded	string	http header: application/x-www-form-urlencoded
    C		string	Card Type: VI=Visa, CA=Mastercard/Eurocard, AX=American Express,DS=Discover Card,DC=Diners Club,XS=Access,ME=Maestro
    P		string	PAN/Credit Card Number (P=5454545454545454)
    H		string	Credit Card Holder (H=FIRSTNAME+LASTNAME)
    V		string	CVC/Card Validation Code (V=123)
    M		string	Expiration Month (M=12) = format : MM
    Y		string	Expiration Year (Y=2020) = format : YYYY

• Bookings

  • List Methods
  • Expand Methods

  • POST pnrlesspricing /sales/bookings/pnrlesspricing

    This endpiont remains same for pnrlesspricing initial & second call. Retrieves the pnr pricing response with OND : LHR to FRA, with LH flight numbers 923(onward journey) and 900(return journey) for given /allfares or /lowest fares output

    Parameter	Value	Type	Description
    Accept	application/xml	string	http header: application/xml
    Content-Type	application/xml	string	http header: application/xml

    Request Body
  • POST book /sales/bookings/book

    Retrive the airsegments from pnrlesspricing reseponse & add the payment token & passenger billing information to crate booking. this endpoint to create PRN. for LH flight numbers 923(onward journey) and 900(return journey)

    Parameter	Value	Type	Description
    Accept	application/xml	string	http header: application/xml
    Content-Type	application/xml	string	http header: application/xml

    Request Body

• Reference Data

  • List Methods
  • Expand Methods

  • GET Countries 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 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 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 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 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 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 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 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 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 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 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)
    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 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)
    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 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 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 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 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 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 cargo/shipmentTracking/{aWBPrefix}-{aWBNumber}

    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 application/xml	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	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