LH OpenAPI testing

• 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 (e.g 'LHR'). other airport codes not supported
    destination		string	Enter journey destination (e.g '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 e.g. 'LH'
    origin		string	Journey origin. 3-letter IATA aiport code e.g. 'LHR'
    destination		string	Journey destination. 3-letter IATA airport code e.g. '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 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 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 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 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 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