AllFares
The All Fares resource retrieves the all possible fares for a specific origin & destination pair on a given date. The all fares can be searched across several airlines.
- Return fares are available for Lufthansa, Swiss Airlines, and Austrian Airlines.
- One-way and return fares are available for Germanwings/Eurowings.
In addition to the airline (=catalogue), you must provide the origin, destination & desired travel date in order to perform a fare search. If a return fare is required please also include the return date in the fare search query.
The number and type of travelers may also be provided e.g. (adult=2;child=1;infant=1). If no traveler information is provided a fare for one adult will be returned.
For Lufthansa, Germanwings, Swiss Airlines and Austrian Airlines only economy class fares are provided. If no cabin class is provided, economy class will be set as default for the fare search.
For Germanwings you may also provide a fare-family. If no fare-family is provided the BASIC fare family will be set as default.
For Germanwings, Swiss and Austrian Airlines we include a deep link to the respective airline's booking portal. For details on how to create a deep link for Lufthansa please click here
We provide the all fares for Lufthansa, Germanwings, Swiss and Austrian Airlines fares. See our lowest & best fares service for multi-carrier lowest/best fare search, including Germanwings/Eurowings, Swiss Airlines, Lufthansa and Austrian Airlines
Request URI
Code snippet: Call
/v1/offers/fares/allfares?catalogues={catalogue}&origin={origin}&destination={destination}&travel-date={outboundDate}&[return-date={returnDate}]&[cabin-class={cabinClass}]&travelers=([adult={NumberOfPassengers}];[child={NumberOfPassengers}];[infant={NumberOfPassengers}])&[fare-family={FareType}]&[trackingid={trackingid}]Note: please use catalogue code '4U' to search for both Germanwings (4U) & Eurowings (EW)
| Variable | Description | Format |
|---|---|---|
| {catalogue} | Fares catalogue to be searched (LH, 4U, LX, OS) - only | 2-character IATA airline designator code. |
| {origin} | The departure airport. | 3-letter IATA code, e.g. “FRA”. |
| {destination} | The arrival airport. | 3-letter IATA code, e.g. "JFK". |
| {out} | Outbound travel date | yyyy-MM-dd. |
| {return-date} | Return travel date | yyyy-MM-dd. |
| {cabinClass} | Cabin Class (LX, OS, LH - only) | Economy, Business |
| {NumberOfPassengers} | Number of passengers of the corresponding type | format to represent (adult=<NumberOfPassengers>;child=<NumberOfPassengers>;infant=<NumberOfPassengers>) e.g. (adult=2;child=2;infant=1), only adult eg: (adult=1) |
| {trackingid} | web tracking id (OS,LX,LH only) | string e.g. "WebFrontEND_APP" |
| {FareType} | Fare family (cabin class) (4U - only) | String e.g. basic, smart, best, smartflex, bestflex (Germanwings/Eurowings only) |
Request Examples
One Way Fare Search (available for Germanwings & Eurowings only)
Code snippet: Call
/v1/offers/fares/allfares?catalogues=4U&fare-family=basic&origin=CGN&destination=ZRH&travel-date=2016-08-30&cabin=economy&travelers=(adult=2;child=2;infant=1)
Return Fare Search
Code snippet: Call
/v1/offers/fares/allfares?catalogues=4U;OS;LX;LH&fare-family=basic&origin=CGN&destination=ZRH&travel-date=2017-08-30&return-date=2017-09-02&cabin=economy&travelers=(adult=2;child=2;infant=1)
Response Structure Definition
Fares are located within the OffersGroup section of the response. Within this section you will find AirlineOffers per carrier catalogue. A fare will be shown as an offer and will include the total fare charge as well as the fare per passenger type (e.g. Adult, Child etc ). Within each offer we also provide a deep link to the airlines' booking portal.
An offer contains both fare charges and flight segment information. Each offer contains a reference to the applicable flights for that offer. Within ApplicableFlights the FlightSegmentReference element holds the reference and links to the SegmentKey within DataLists\FlightSegmentList. The structure of the response is shown below:
| Key | Description |
|---|---|
| FaresResource Response | Root element of the fares response. |
| .AirShoppingRS | Element contains the main body of the response |
| ..Document | Contains message response reference data |
| ...MessageVersion | Message version |
| ...CreateTime | Response message creation time |
| ..AirShoppingRSProcessing | Contains message status data |
| ...Status | Message status |
| ..ShoppingResponseIDs | Contains shopping response ID |
| ...ResponseID | Shopping response ID |
| ..OffersGroup | Element contains the Airline Offers |
| ...AirlineOffers | Airline Offers are held in this element |
| ....TotalOfferQuantity | Total number of returned airline offers |
| ....AirlineOfferSnapshot | Fare store reference information |
| .....DateTime | Time stamp of fare store data |
| ....Owner | Fare store owner |
| ....AirlineOffer | Holds the airline offers |
| .....OfferID [ ] | Array containg each airline offer |
| ......Owner | Holds the airline owner of the fares data |
| ......Text | Cotntains the OfferID reference number |
| .....TotalPrice | Element holds the offer total fare information |
| ......DetailCurrencyPrice | Contains Currency Details for the offer |
| .......Total | Total Fare |
| ........Code | Total Fare currency code, e.g EUR, encoding schema ISO 4217 (three alpha characters) |
| ........Text | Total fare amount |
| .......Taxes | Holds the total tax charges which apply to the fare |
| ........Total | Holds Total tax information |
| .........Code | Total tax currency code, e.g EUR, encoding schema ISO 4217 (three alpha characters) |
| .........Text | Total tax amount |
| .....PricedOffer | Fare information is contained within this element |
| ......OfferPrice | The OfferPrice element holds one or more offerItems. Each offerItem relates to the fare for a passenger type e.g Adult, Child or Infant fare |
| .......OfferItemID [ ] | Contans the reference number of the respective offer item |
| .......RequestedDate | Holds the fare price for the requested date. |
| ........PriceDetail | Element contains detailed price information, including total amount, base fare amount and other details |
| .........TotalAmount | Holds total fare amount of a single passenger of this type (e.g. Adult, Child etc. ) |
| ..........SimpleCurrencyPrice | details of the fare price currency |
| ...........Code | Currency Code, Example EUR, encoding schema ISO 4217 (three alpha character) |
| ...........Text | Fare amount |
| .........BaseAmount | Total base fare amount, this includes surcharges if applicable |
| ..........Code | Currency code, e.g EUR encoding schema ISO 4217 (three alpha characters) |
| ..........Text | Total base amount |
| .........Taxes | Tax Information |
| ..........Total | Tax breakdwon sub-total amount |
| ...........Code | Currency code |
| ...........Text | Total tax |
| ........Associations | Fare offer associations |
| .........AssociatedTraveler | Includes anonymous known and or PTC Traveler assocation |
| ..........TravelerReference | Traveler reference |
| .......FareDetail | Fare detail for the offer |
| ........FareComponent | Fare component per O&D is provided |
| .........AirlineID | Airline providing the offer |
| .........DepartureCode | Departure City or Airport |
| .........DepartureDate | Depature Date |
| .........ArrivalCode | Arrival City or Airport |
| ..........FareBasis | Contains fare related data |
| ...........FareBasisCode | Holds the fare basis code |
| ............Code | Contains the fare basis code |
| ......Associations | Provides offer related information |
| .......ApplicableFlight | Applicable flights for the fare. |
| .......FlightSegmentReference | Holds the flight segment reference.Association to single flight segment instance(s) Example: Segement 1 |
| ........Ref [ ] | Contains the flight segment reference. This references to a flight segment within the DataLists section |
| ........ClassOfService | Holds class of service information |
| .........Code | Class of service code |
| ..........SeatsLeft | Indicates how many seats are still available in this class of service |
| ..........Text | Class of service code: one letter code. Example 'F' for first class, 'C' for business |
| .........MarketingName | Cabin Class marketing name e.g Premium Economy, Econonmy Server, Business Flex etc |
| .......OtherAssociation | Other detail assocation |
| ........Type< | Type of reference = deep link |
| ........ReferenceValue | Contains the deep link for this offer |
| ..DataLists | Data Lists |
| ...AnonymousTravelerList | Anonymous Traveler data list definition |
| ....AnonymousTraveler | Anonymous Traveler |
| .....ObjectKey | Object globally unique instance ID |
| .....PTC | Passenger type code |
| ......Quantity | Traveler quantity |
| ......Text | Holds the value for the passenger type code: ADT=Adult, CHD=Child, INF=Infant |
| ...FlightSegmentList | List of flight segments |
| ....FlightSegment | Flight segment information. Contains details of flight segments |
| .....SegmentKey | A globally unique identifier for the flight segment. The SegmentKey relates to flights that are referenced within the offer |
| .....Departure | Departure origin airport |
| ......AirportCode | Departure airport location code e.g CGN |
| ......Date | Departure date. Example 2016-08-02 |
| ......Time | Departure time. Example 09:15 |
| .....Arrival | Arrival (destination) airport |
| ......AirportCode | Arrival airport location code e.g ZRH |
| ......Date | Arrival date Example 2016-08-21 |
| ......Time | Arrival time. Exampe 10:30 |
| .....MarketingCarrier | Marketing carrier information |
| ......AirlineID | Airline designator ID. Example LH, encoding scheme IATA/A4A (two or three character) airline designator code |
| ......FlightNumber | Flight number. Example '400', or OPEN or ARNK |
| .Meta | Element containing meta data |
| ..Version | version number |
| ..Link | Element specifying links |
| ...Href | link to actual resource |
| ...Rel |
Specifying 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). |
Deep Link
Each returned offer will contain a deep link to the carriers booking portal. Use the link to access the booking process
Code snippet: URL
https://www.eurowings.com/skysales/Deeplink.aspx?o=nue&d=dub&od=2017-05-05&t=o&adt=2&chd=1&inf=1&flnro=9063&f=basicResponse Example
Code snippet: XML
<?xml version="1.0" encoding="UTF-8"?>
<FaresResponse>
<AirShoppingRS>
<Document>
<MessageVersion>1.0.0-db</MessageVersion>
<CreateTime>2016-10-07T10:41:23.697-00:00</CreateTime>
</Document>
<AirShoppingProcessing>
<Status>Complete</Status>
</AirShoppingProcessing>
<ShoppingResponseIDs>
<ResponseID>6aa9fb68-1c6e-459e-96df-3ff31a0e6727</ResponseID>
</ShoppingResponseIDs>
<OffersGroup>
<AirlineOffers>
<TotalOfferQuantity>1</TotalOfferQuantity>
<AirlineOfferSnapshot DateTime="2016-10-01T00:06:18.000-00:00"/>
<Owner>4U</Owner>
<AirlineOffer>
<OfferID Owner="4U">e2ad3a17-808a-4c02-9a63-1d4a5275beac</OfferID>
<TotalPrice>
<DetailCurrencyPrice>
<Total Code="EUR">279.57</Total>
<Taxes>
<Total Code="EUR">0</Total>
</Taxes>
</DetailCurrencyPrice>
</TotalPrice>
<PricedOffer>
<OfferPrice OfferItemID="1015cc42-d6e5-4330-9d20-eb4fc4825997">
<RequestedDate>
<PriceDetail>
<TotalAmount>
<SimpleCurrencyPrice Code="EUR">89.99</SimpleCurrencyPrice>
</TotalAmount>
<BaseAmount Code="EUR">89.99</BaseAmount>
<Taxes>
<Total Code="EUR">0</Total>
</Taxes>
</PriceDetail>
<Associations>
<AssociatedTraveler>
<TravelerReferences>84d6ea12-8ec7-4482-a25d-038261afbd35_ADT</TravelerReferences>
</AssociatedTraveler>
</Associations>
</RequestedDate>
<FareDetail>
<FareComponent>
<AirlineID>4U</AirlineID>
<DepartureCode>NUE</DepartureCode>
<DepartureDate>2017-05-05-00:00</DepartureDate>
<ArrivalCode>DUB</ArrivalCode>
<FareBasis>
<FareBasisCode>
<Code>LX</Code>
</FareBasisCode>
</FareBasis>
</FareComponent>
</FareDetail>
</OfferPrice>
<OfferPriceOffer ItemID="f5966748-674d-4d92-9994-20c7d06ad743">
<RequestedDate>
<PriceDetail>
<TotalAmount>
<SimpleCurrencyPrice Code="EUR">71.99</SimpleCurrencyPrice>
</TotalAmount>
<BaseAmount Code="EUR">71.99</BaseAmount>
<Taxes>
<Total Code="EUR">0</Total>
</Taxes>
</PriceDetail>
<Associations>
<AssociatedTraveler>
<TravelerReferences>84d6ea12-8ec7-4482-a25d-038261afbd35_ADT697441c1-e425-416e-aacd-9860e9e8e2a1_CHD</TravelerReferences>
</AssociatedTraveler>
</Associations>
</RequestedDate>
<FareDetail>
<FareComponent>
<AirlineID>4U</AirlineID>
<DepartureCode>NUE</DepartureCode>
<DepartureDate>2017-05-05-00:00</DepartureDate>
<ArrivalCode>DUB</ArrivalCode>
<FareBasis>
<FareBasisCode>
<Code>LX</Code>
</FareBasisCode>
</FareBasis>
</FareComponent>
</FareDetail>
</OfferPrice>
<OfferPriceOffer ItemID="f0e0d85b-279a-4c03-955c-8a7e93de9f8e">
<RequestedDate>
<PriceDetail>
<TotalAmount>
<SimpleCurrencyPrice Code="EUR">27.60</SimpleCurrencyPrice>
</TotalAmount>
<BaseAmount Code="EUR">27.60</BaseAmount>
<Taxes>
<Total Code="EUR">0</Total>
</Taxes>
</PriceDetail>
<Associations>
<AssociatedTraveler>
<TravelerReferences>84d6ea12-8ec7-4482-a25d-038261afbd35_ADT697441c1-e425-416e-aacd-9860e9e8e2a1_CHDadb8e6b8-0f5d-4830-b4b4-06603c380f01_INF</TravelerReferences>
</AssociatedTraveler>
</Associations>
</RequestedDate>
<FareDetail>
<FareComponent>
<AirlineID>4U</AirlineID>
<DepartureCode>NUE</DepartureCode>
<DepartureDate>2017-05-05-00:00</DepartureDate>
<ArrivalCode>DUB</ArrivalCode>
<FareBasis>
<FareBasisCode>
<Code>LX</Code>
</FareBasisCode>
</FareBasis>
</FareComponent>
</FareDetail>
</OfferPrice>
<Associations>
<ApplicableFlight>
<FlightSegmentReference ref="1d99b798-1f9e-4624-9350-ad2fa89bf564_SEGEW9063">
<ClassOfService>
<Code SeatsLeft="46">L</Code>
<MarketingName>BASIC</MarketingName>
</ClassOfService>
</FlightSegmentReference>
<FlightSegmentReference ref="01b94f22-3237-4533-b7cf-1f3298dfe4c4_SEG4U9394">
<ClassOfService>
<Code SeatsLeft="46">L</Code>
<MarketingName>BASIC</MarketingName>
</ClassOfService>
</FlightSegmentReference>
</ApplicableFlight>
<OtherAssociation>
<Type>deeplink</Type>
<ReferenceValue>https://www.germanwings.com/skysales/Deeplink.aspx?o=nue&d=dub&od=2017-05-05&t=o&adt=2&chd=1&inf=1&flnro=9063&f=basic</ReferenceValue>
</OtherAssociation>
</Associations>
</PricedOffer>
</AirlineOffer>
</AirlineOffers>
</OffersGroup>
<DataLists>
<AnonymousTravelerList>
<AnonymousTraveler ObjectKey="84d6ea12-8ec7-4482-a25d-038261afbd35_ADT">
<PTCQuantity="2">ADT</PTC>
</AnonymousTraveler>
<AnonymousTraveler ObjectKey="697441c1-e425-416e-aacd-9860e9e8e2a1_CHD">
<PTCQuantity="1">CHD</PTC>
</AnonymousTraveler>
<AnonymousTraveler ObjectKey="adb8e6b8-0f5d-4830-b4b4-06603c380f01_INF">
<PTCQuantity="1">INF</PTC>
</AnonymousTraveler>
</AnonymousTravelerList>
<FlightSegmentList>
<FlightSegment SegmentKey="1d99b798-1f9e-4624-9350-ad2fa89bf564_SEGEW9063">
<Departure>
<AirportCode>NUE</AirportCode>
<Date>2017-05-05-00:00</Date>
<Time>08:35</Time>
</Departure>
<Arrival>
<AirportCode>DUS</AirportCode>
<Date>2017-05-05-00:00</Date>
<Time>09:30</Time>
</Arrival>
<MarketingCarrier>
<AirlineID>EW</AirlineID>
<FlightNumber>9063</FlightNumber>
</MarketingCarrier>
</FlightSegment>
<FlightSegment SegmentKey="01b94f22-3237-4533-b7cf-1f3298dfe4c4_SEG4U9394">
<Departure>
<AirportCode>DUS</AirportCode>
<Date>2017-05-05-00:00</Date>
<Time>10:40</Time>
</Departure>
<Arrival>
<AirportCode>DUB</AirportCode>
<Date>2017-05-05-00:00</Date>
<Time>11:30</Time>
</Arrival>
<MarketingCarrier>
<AirlineID>4U</AirlineID>
<FlightNumber>9394</FlightNumber>
</MarketingCarrier>
</FlightSegment>
</FlightSegmentList>
</DataLists>
</AirShoppingRS>
<Meta Version="1.0.0">
<Link Href="https://api-test.lufthansa.com/v1/offers/fares/allfares?catalogues=4U&carriers=4U&fare-types=BASIC&segments=(origin=NUE;destination=DUB;travel-date=2017-05-05;cabin=Economy)&travelers=(adult=2;child=1;infant=1)"Rel="self"/>
</Meta>
</FaresResponse>