Deep Links
Use the deep link service to generate valid deep links to Lufthansa's portal booking process on lh.com. The API will construct a correctly formatted deep link with all the necessary parameter encryption to the LH booking engine.
The deep link service provides two types of deep links FFP Deep Links and ITCO Deep Links
FFP Deep Links
FFP deep links will lead you/your customer to the flight selection screen in lh.com.
To receive an FFP link please make sure to enter the following parameters
- origin
- destination
- travel-date
- return-date (leave blank for one-way journeys)
- trackingid (you received after registration - please ensure correct spelling as this parameter tracks your purchase)
- lang
- country
FFP Request URI
Code snippet: URL
/v1/offers/faresdeeplink/deeplink/ffp?origin={origin}&destination={destination}&travel-date={outboundDate}[&return-date={returnDate}][&cabin-class={cabinClassCode}][&travelers=([adult={numberOfPassengers}];[child={numberOfPassengers}];[infant={numberOfPassengers}]&[partnerid={partnerID}][&encrytpion-key{encryptionKey}]&trackingid={trackingID}&lang={language}&country={countryCode}
FFP input parameters
Variable | Description | Format |
---|---|---|
{origin} | Origin airport/city code - Mandatory | 3-letter IATA code, e.g. “FRA”. |
{destination} | Destination airport/city code - Mandatory | 3-letter IATA code, e.g. "MUC". |
{travel-date} | Outbound travel date - Mandatory | yyyy-MM-dd. e.g. '2016-10-27' |
{return-date} | Return travel date - Optional | yyyy-MM-dd. e.g. '2016-10-27' |
{cabin-class} | Cabin Class Code - Optional | Cabin class: 'economy', 'premium_economy', 'business', first' |
{travelers} | Optional - Number of passengers of the corresponding type - Optional (adult=1 will be used as default) | Two digit number Adult=2 Child=2 Infant=1 |
{partnerid} | Partner identification - Optional | integer e.g.1071 |
{encryption-key} | Encryption key - Optional | AES key |
{trackingid} | Web tracking identification - Mandatory | alpha numeric string e.g. 'MYDummyID' |
{lang} | Language code - Mandatory | 2 letter language code e.g. "DE" |
{country} | Country code - Mandatory | 2 letter country code e.g. "DE" |
You don't need to worry about encryption key and partner id. These will be automatically set if not provided.
Request Examples
Code snippet: Call
/v1/offers/faresdeeplink/deeplink/ffp?origin=FRA&cabin-class=Economy&country=de&partnerid=13100&encryption-key=C49A99BBF61C2992A14E60D3F21ABCF&travel-date=2016-10-12&return-date=2016-11-12&lang=de&travelers=(adult=3;child=2;infant=1)&trackingid=dummyTrackingID
ITCO Deep Links
ITCO deep links lead you/your customer to the booking screen of lh.com with the flights already in the shopping cart.
To receive an ITCO deep link make sure to fill all the FFP parameters from above as well as the following parameters:
- fare
- outbound-segments
- return-segments
ITCO Request URI
Code snippet: URL
/v1/offers/faresdeeplink/deeplink/itco?&origin={origin}&destination={destination}&travel-date={outboundDate}[&return-date={returnDate}][&cabin-class={cabinClassCode}][&outbound-segments={outboundSegment}][&return-segments={returnSegment}][&travelers=([adult={numberOfPassengers}];[child={numberOfPassengers}];[infant={numberOfPassengers}][&fare=totalFare}][&net-fare=netFare}][&fare-currency=fareCurrency}]&[partnerid={partnerID}][&encrytpion-key{encryptionKey}]&trackingid={trackingID}&lang={language}&country={countryCode}
ITCO input parameters
Variable | Description | Format |
---|---|---|
{origin} | Origin airport/city code - Mandatory | 3-letter IATA code, e.g. “FRA”. |
{destination} | Destination airport/city code- Mandatory | 3-letter IATA code, e.g. "MUC". |
{travel-date} | Outbound travel date- Mandatory | yyyy-MM-dd. e.g. '2016-10-27' |
{return-date} | Return travel date - Optional | yyyy-MM-dd. e.g. '2016-10-27' |
{cabin-class} | Cabin Class Code - Optional | Cabin class: 'economy', 'premium_economy', 'business', first' |
{outbound-segments} | Enter outbound flight segments in the sequence of outbound travel - Mandatory | e.g. 'e.g. LH096;LH480' |
{return-segments} | Enter return flight segments in the sequence of return travel - Mandatory for return journey | e.g. 'LH7465;LH431' |
{travelers} | Number of passengers of the corresponding type - Optional (adult=1 will be used as default) | Two digit number Adult=2 Child=2 Infant=1 |
{fare} | Total fare - Mandatory | e.g 100.50 |
{net-fare} | Net fare - Optional | e.g 10.20 |
{fare-currency} | Fare currency - Mandatory | three letter currency code e.g. 'EUR' |
{partnerid} | Partner identification - Optional | integer e.g.1071 |
{encryption-key} | Encryption key - Optional | AES key |
{trackingid} | Web tracking identification - Mandatory | alpha numeric string e.g. 'MYDummyID' |
{lang} | Language code - Mandatory | 2 letter language code e.g. "DE" |
{country} | Country code - Mandatory | 2 letter country code e.g. "DE" |
Request Examples
Code snippet: URL
/v1/offers/faresdeeplink/deeplink/itco?fare-currency=EUR&return-segments=LH401&origin=FRA&fare=1018.34&cabin-class=Economy&country=de&partnerid=13100&encryption-key=C49A99BBF61C2992A14E60D3F21ABCF&travel-date=2016-10-12&return-date=2016-11-12&lang=de&outbound-segments=LH400&travelers=(adult=3;child=2;infant=1)&trackingid=dummyTrackingID
Response Structure Definition
Key | Description |
---|---|
DeepLinkResponse | Element contains the main body of the response |
.DeepLinks | Contains message response reference data |
..DeepLink | Message version |
..@ID | Response message creation time |
@mode |
|
@link | contains the deep link URL |
.Meta | Container for meta links |
..Link | Use the links to access further detail related to the notified message |
@Href | Link to actual resource |
@Rel | Specifying the kind of link, such as 'self' (link that returned this response), ‘alternate’ (link that points to another resource) or ‘related’ (link that points to related resource). |
Response Examples
<DeepLinkResponse>
<DeepLinks>
<DeepLink id="6a45efa2-1645-4947-895d-10a96fd2bbc6" mode="D" link="https://uat3.lufthansa.com/deeplink......."/>
<DeepLink id="d98c3bdf-6b4b-4a57-9689-49ffe7972939" mode="I" link="https://uat3.lufthansa.com/deeplink......."/>
</DeepLinks>
<Meta Version="1.0.0">
<Link Href="https://api-test.lufthansa.com/fares_v1.0.0/fares/deeplink?fare-currency=CZK&............" Rel="self"/>
</Meta>
</DeepLinkResponse>
Docs Navigation
- Lufthansa Open API
- Getting Started
- Public API Method Details
- Cargo
- Flight Schedules
- Reference Data
- Offers
- Operations
- Flight Schedules
- Flight Status
- Flight Status by Route
- Flight Status at Arrival Airport
- Flight Status at Departure Airport
- Flight Status Response
- Flight Status at Arrival Airport or Departure Response
- Customer Flight Information
- Customer Flight Information at Arrival Airport
- Customer Flight Information by Route
- Customer Flight Information at Departure Airport
- Customer Flight Information Response
- Notifications
- Partner API Method Details
- FlightOps/Crew API Method Details