LH Partner API
The LH Partner API supplies airline partners with operational data and services such as baggage‑trip lookup, fare searching (including best, lowest, and subscription fares), deep‑link generation for bookings, order retrieval, auto‑check‑in, price‑offer promotions, seat‑detail information, and network data (routes, status, and top routes) for Lufthansa and its associated carriers.
Admin: update documentationGET
/baggage/baggagetripandcontact/{searchID}
Baggage Trip and Contact
searchID ( path , required ) — Bag tag number, PNR, boarding card or FQTV IDAccept ( header , required ) — http header: application/json or application/xml (Acceptable values are: "application/json", "application/xml")GET
/offers/fares/allfares
All Fares
catalogues ( query , required ) — Specifies in which catalogue the fares need to be searched (e.g.'4U;OS').origin ( query , required ) — Enter journey origin (e.g 'FRA').destination ( query , required ) — Enter journey destination (e.g 'MAD').travel-date ( query , required ) — Enter journey travel-date (e.g 2016-10-20)return-date ( query ) — Enter journey return-date (e.g 2016-10-31)'.cabin-class ( query ) — Enter the required cabin class (e.g econonmy, business etc.). (Acceptable values are: "", "economy", "premium economy", "business", "first")travelers ( query ) — Specifies the type and number of travelers (e.g. '(adult=2;child=2;infant=1)') For LH only (adult=1) possible.fare-family ( query ) — Mandatory for 4U. Specifies, which fares to be returned, such as basic, smart, best, smartflex, bestflex . (Acceptable values are: "", "basic", "smart", "best", "smartflex", "bestflex")trackingid ( query ) — Austrian Airlines only - specify the web tracking id to be used in OS Deep link.Accept ( header ) — Mandatory http header: application/xml or application/jsonGET
/offers/fares/bestfares
Best Fares
catalogues ( query , required ) — Search fares from these carriers' catalogues (e.g. '4U;OS;LH')origin ( query , required ) — Journey origin. 3-letter IATA airport code (e.g. 'FRA')destination ( query , required ) — Journey destination. 3-letter IATA airport code (e.g. 'MAD')travel-date ( query , required ) — Journey travel-date (YYYY-MM-DD)trip-duration ( query , required ) — Trip duration in days (e.g. '7')range ( query , required ) — Fare range: 'byday' or 'bymonth' (Acceptable values are: "byday", "bymonth")Accept ( header , required ) — http header: application/json or application/xml (Acceptable values are: "application/json", "application/xml")cabin-class ( query ) — Cabin class: 'economy', 'premium_economy', 'business', 'first' (Acceptable values are: "", "economy", "premium_economy", "business", "first")country ( query ) — Country code of requestor. 2-letter ISO 3166-1 country code (e.g. 'de')trackingid ( query ) — Austrian Airlines only - specify the web tracking id to be used in OS Deep link.fare-family ( query ) — Fare family: basic, smart, best, smartflex, bestflex - Germanwings only (Acceptable values are: "", "basic", "smart", "best", "smartflex", "bestflex")GET
/offers/fares/deeplink
Deep Links
catalogues ( query , required ) — Carrier for which the deep link will be created (e.g. 'LH')trackingid ( query , required ) — Deep link tracking IDcountry ( query , required ) — 2-letter ISO 3166-1 country codelang ( query , required ) — 2-letter ISO 3166-1 language codeAccept ( header , required ) — http header: application/json or application/xml (Acceptable values are: "application/json", "application/xml")origin ( query ) — Journey origin. 3-letter IATA airport or city code (e.g. 'FRA')origin-name ( query ) — Journey origin airport or city name (e.g. 'frankfurt')destination ( query ) — Journey destination. 3-letter IATA airport or city code (e.g. 'MAD')destination-name ( query ) — Journey destination airport or city name (e.g. 'madrid')travel-date ( query ) — Journey travel-date (YYYY-MM-DD)return-date ( query ) — Journey return-date (YYYY-MM-DD)cabin-class ( query ) — Cabin class: 'economy', 'premium_economy', 'business', 'first' (Acceptable values are: "", "economy", "premium_economy", "business", "first")outbound-segments ( query ) — Outbound flight segments in the sequence of travel (e.g. 'LH096;LH480')return-segments ( query ) — Flight segments in the sequence of travel (e.g. 'LH7465;LH431')travelers ( query ) — Type and number of travelers (e.g. '(adult=2;child=2;infant=1)')fare ( query ) — Travel fare (e.g. '1341.45')net-fare ( query ) — Travel net fare. Total fare less taxes and charges (e.g. '1140')fare-currency ( query ) — Fare currency (e.g. 'EUR')partnerid ( query ) — Deep link partner id (e.g. '1247')encryption-key ( query ) — Deep link encryption-keyGET
/offers/fares/deeplink/ffp
LH Deep Links - FFP
catalogues ( query , required ) — Carrier for which the deep link will be created (e.g. 'LH')origin ( query , required ) — Journey origin. 3-letter IATA airport or city code (e.g. 'FRA')destination ( query , required ) — Journey destination. 3-letter IATA airport or city code (e.g. 'MAD')travel-date ( query , required ) — Journey travel-date (YYYY-MM-DD)trackingid ( query , required ) — Deep link tracking IDcountry ( query , required ) — 2-letter ISO 3166-1 country codelang ( query , required ) — 2-letter ISO 3166-1 language codeAccept ( header , required ) — http header: application/json or application/xml (Acceptable values are: "application/json", "application/xml")return-date ( query ) — Journey return-date (YYYY-MM-DD)cabin-class ( query ) — Cabin class: 'economy', 'premium_economy', 'business', 'first' (Acceptable values are: "", "economy", "premium_economy", "business", "first")travelers ( query ) — Type and number of travelers (e.g. '(adult=2;child=2;infant=1)')partnerid ( query ) — Deep link partner id (e.g. '1247')encryption-key ( query ) — Deep link encryption-keyGET
/orders/orders/{orderID}/{name}
Orders
orderID ( path , required ) — Unique order identifierAccept ( header , required ) — http header: application/json or application/xml (Acceptable values are: "application/json", "application/xml")name ( path , required ) — Surname of travellerGET
/offers/fares/deeplink/itco
LH Deep Links - ITCO
catalogues ( query , required ) — Carrier for which the deep link will be created (e.g. 'LH')origin ( query , required ) — Journey origin. 3-letter IATA airport or city code (e.g. 'FRA')destination ( query , required ) — Journey destination. 3-letter IATA airport or city code (e.g. 'MAD')travel-date ( query , required ) — Journey travel-date (YYYY-MM-DD)outbound-segments ( query , required ) — Outbound flight segments in the sequence of travel (e.g. 'LH096;LH480')fare ( query , required ) — Travel fare (e.g. '1341.45')fare-currency ( query , required ) — Fare currency (e.g. 'EUR')trackingid ( query , required ) — Deep link tracking IDcountry ( query , required ) — 2-letter ISO 3166-1 country codelang ( query , required ) — 2-letter ISO 3166-1 language codeAccept ( header , required ) — http header: application/json or application/xml (Acceptable values are: "application/json", "application/xml")return-date ( query ) — Journey return-date (YYYY-MM-DD)cabin-class ( query ) — Cabin class: 'economy', 'premium_economy', 'business', 'first' (Acceptable values are: "", "economy", "premium_economy", "business", "first")return-segments ( query ) — Flight segments in the sequence of travel (e.g. 'LH7465;LH431')travelers ( query ) — Type and number of travelers (e.g. '(adult=2;child=2;infant=1)')net-fare ( query ) — Travel net fare. Total fare less taxes and charges (e.g. '1140')partnerid ( query ) — Deep link partner id (e.g. '1247')encryption-key ( query ) — Deep link encryption-keyGET
/offers/fares/fares
Fares
catalogues ( query , required ) — Search fares from these carriers' catalogues - currently active for Germanwings only (4U)segments ( query , required ) — Journey details e.g. (origin=TXL;destination=CGN;travel-date=2016-12-15;return-date=2016-12-20;cabin=Economy)carriers ( query , required ) — Include fares for these carriers e.g. ('4U;LH')Accept ( header , required ) — http header: application/json or application/xml (Acceptable values are: "application/json", "application/xml")travelers ( query ) — Type and number of travelers e.g. (adult=1;child=1;infant=1)fare-types ( query ) — Fares family: basic,smart, best, smartflex, bestflex - Germanwings only (Acceptable values are: "", "basic", "smart", "best", "smartflex", "bestflex")GET
/offers/fares/lowestfares
Lowest Fares
catalogues ( query , required ) — Search fares from these carriers' catalogues e.g. '4U;OS;LH'origin ( query , required ) — Journey origin. 3-letter IATA aiport code e.g. 'FRA'destination ( query , required ) — Journey destination. 3-letter IATA airport code e.g. 'MAD'travel-date ( query , required ) — Journey travel-date YYYY-MM-DDAccept ( header , required ) — http header: application/json or application/xml (Acceptable values are: "application/json", "application/xml")return-date ( query ) — Journey return-date - mandatory for OS and LH searches YYYY-MM-DDcabin-class ( query ) — Cabin class: 'economy', 'premium_economy', 'business', 'first' (Acceptable values are: "", "economy", "premium_economy", "business", "first")travelers ( query ) — Type and number of travelers e.g. '(adult=2;child=2;infant=1)'. For LH only (adult=1) possiblefare-family ( query ) — Fare family: basic, smart, best, smartflex, bestflex - Germanwings only (Acceptable values are: "", "basic", "smart", "best", "smartflex", "bestflex")country ( query ) — Country code of requestor. 2-letter ISO 3166-1 country code (e.g. 'de')GET
/offers/fares/subscriptions
Fares Subscriptions
origin ( query , required ) — Journey origin. 3-leter IATA airport code (e.g. 'FRA')destination ( query , required ) — Journey destination. 3-letter IATA airport code (e.g. 'MAD')cabin-class ( query , required ) — Cabin class: 'economy', 'premium_economy', 'business', 'first' (Acceptable values are: "", "economy", "premium_economy", "business", "first")trip-duration ( query , required ) — Trip duration in days (e.g. '7')email ( query , required ) — Email Address')lang ( query , required ) — 2-letter ISO 3166-1 language codeAccept ( header , required ) — http header: application/json or application/xml (Acceptable values are: "application/json", "application/xml")country ( query ) — 2-letter ISO 3166-1 country codetrackingid ( query ) — Tracking parameterGET
/offers/ond/route/{origin}/{destination}
OND Route
origin ( path , required ) — Enter either the orgin city or orgin country code (e.g 'FRA' or 'DE'). Enter '*' for alldestination ( path , required ) — Enter either the destination city or country code (e.g 'MAD' or 'ES'). Enter '*' for allAccept ( header , required ) — Mandatory http header: application/xml or application/jsoncatalogues ( query ) — Carrier for which the OND will be retrieved (e.g. 'LH')limit ( query , limit ) — 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 ( query , offset ) — Number of records skipped. Defaults to 0GET
/offers/ond/status
OND Status
Accept ( header , required ) — Mandatory http header: application/xml or application/jsoncatalogues ( query ) — Carrier for which the OND will be retrieved (e.g. 'LH')new-routes ( query ) — Enter if newly added routes should be returned in the response. (Acceptable values are: "", "true", "false")old-routes ( query ) — Enter if old (deleted) routes should be returned in the response. (Acceptable values are: "", "true", "false")GET
/offers/ond/top
Top OND
Accept ( header , required ) — Mandatory http header: application/xml or application/jsoncatalogues ( query ) — Carrier for which the OND will be retrieved (e.g. 'LH')origin ( query ) — Enter the origin country code (e.g. 'DE'). Leave empty to search Top OND across all countriesPUT
/preflight/autocheckin/{ticketnumber}
Auto Check-In
ticketnumber ( path , required ) — Ticket numberemailAddress ( query , required ) — Email addressAccept ( header , required ) — http header: application/json or application/xml (Acceptable values are: "application/json", "application/xml")GET
/promotions/priceoffers/flights/ond/{origin}/{destination}
Price Offers
origin ( path , required ) — Departure city. 3-letter IATA city codedestination ( path , required ) — Destination city. 3-letter IATA city codedepartureDate ( query , required ) — Departure date in local time (YYYY-MM-DD)returnDate ( query , required ) — Return date in local time (YYYY-MM-DD)service ( query ) — Optional parameter.GET
/references/seatdetails/{aircraftCode}/{cabinCode}
Seat Details
aircraftCode ( path , required ) — Aircraft type. 3-character IATA equipment codeAccept ( header , required ) — http header: application/json or application/xml (Acceptable values are: "application/json", "application/xml")cabinCode ( path , required ) — Cabin class: M, E, C, F (Acceptable values are: "", "M", "E", "C", "F")lang ( query ) — 2-letter ISO 3166-1 language code
16 endpoints auto-detected
Authentication
This API requires authentication: OAuth.
curl -X GET \
"https://api.lufthansa.com/v1/baggage/baggagetripandcontact/{searchID}" api.lufthansa.com · HTTPS only