APIHub
Back to Explore

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.

Transportation
OAuth
HTTPS
CORS: Unknown
Description enriched
Visit official documentation

Latency

2613ms p95

Uptime

100.0% 30d

Playground

Verified

live

Endpoints

REST · JSON
GET

/baggage/baggagetripandcontact/{searchID}

Baggage Trip and Contact

  • searchID (path, required) — Bag tag number, PNR, boarding card or FQTV ID
  • Accept (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/json
GET

/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 ID
  • country (query, required) — 2-letter ISO 3166-1 country code
  • lang (query, required) — 2-letter ISO 3166-1 language code
  • Accept (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-key
GET

/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 ID
  • country (query, required) — 2-letter ISO 3166-1 country code
  • lang (query, required) — 2-letter ISO 3166-1 language code
  • Accept (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-key
GET

/orders/orders/{orderID}/{name}

Orders

  • orderID (path, required) — Unique order identifier
  • Accept (header, required) — http header: application/json or application/xml (Acceptable values are: "application/json", "application/xml")
  • name (path, required) — Surname of traveller
GET

/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 ID
  • country (query, required) — 2-letter ISO 3166-1 country code
  • lang (query, required) — 2-letter ISO 3166-1 language code
  • Accept (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-key
GET

/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-DD
  • Accept (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-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)'. For LH only (adult=1) possible
  • fare-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 code
  • Accept (header, required) — http header: application/json or application/xml (Acceptable values are: "application/json", "application/xml")
  • country (query) — 2-letter ISO 3166-1 country code
  • trackingid (query) — Tracking parameter
GET

/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 all
  • destination (path, required) — Enter either the destination city or country code (e.g 'MAD' or 'ES'). Enter '*' for all
  • Accept (header, required) — Mandatory http header: application/xml or application/json
  • catalogues (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 0
GET

/offers/ond/status

OND Status

  • Accept (header, required) — Mandatory http header: application/xml or application/json
  • catalogues (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/json
  • catalogues (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 countries
PUT

/preflight/autocheckin/{ticketnumber}

Auto Check-In

  • ticketnumber (path, required) — Ticket number
  • emailAddress (query, required) — Email address
  • Accept (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 code
  • destination (path, required) — Destination city. 3-letter IATA city code
  • departureDate (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 code
  • Accept (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