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 see 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
{catalogues} 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".
{travel-date} Outbound travel date yyyy-MM-dd.
{return-date} Return travel date yyyy-MM-dd.
{cabin-class} Cabin Class (LX, OS, LH - only) Economy, Business
{travelers} 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"
{fare-family} 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=basic

Response 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>

version 21 as of 6 months ago by marcus