You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 2 Next »

searchFlightsJourney operation finds flight solutions for the specified search criteria, controls the results with one or more parameters, and returns search results in XML as a result set. Solutions include information for a whole requested journey (no matter OneWay, RoundTrip or MultiCity) and operation does not require additional requests in case RoundTrip or MultiCity.

Table of contents

Request (AirShoppingRQ)

Required inputs

#NameDescription
1

Agent credentials

Use credentials that you received from our technical support. Check out Quick Start for how to get it and References for more details
2Passengers

List of PTC and their quantity for the whole journey

3Itinerary

Info for each slice (one slice for One Way trip, two for Round Trip and more for MultiCity. Check glossary for more info):

  • departure city or airport IATA code and date
  • arrival city or airport IATA code and date

Optional parameters

#NameDescription
13D agreement credentials

To apply appropriate discounts, which depends on corporate client, agent and itinerary details.

(warning) Available only for scenario with 3D AgreementUse credentials that you received from our technical support. Check out Quick Start for how to get those IDs

Skipping of 3D agreement credentials input provides receiving prices without discounts for the corporate client

2Sale Currency

Choose your sale currency for prices in response:

  1. RUB
  2. USD
  3. EUR
  4. CNY
  5. KZT

RUB used by default

(warning) Sale currency for search does not depend on Agent credentials

(warning) It is not a double currency conversion (the filed fare currency → the airline's sale currency → the agent's sale currency)
Conversion is executed to the agent's sale currency directly from the filed fare currency

3Fare Output Type


  1. BrandedFares — to receive pricing divided by fare families for each itinerary solution (each itinerary mostly includes 4 or 2 sub options)
  2. LowFare — for the only one cheapest fare for each itinerary solution

BrandedFares used by default

4Sorting Type

Sorts the results based on the following values in each solution (from lowest to highest)

  1. arrival — arrival (earliest to latest), total price (lowest to highest), departure (earliest to latest), duration (shortest to longest)
  2. carrier — single carrier firststop count (fewest to most), total price (lowest to highest), departure (earliest to latest)
  3. departure — departure (earliest to latest), total price (lowest to highest), duration (shortest to longest)
  4. default — total price (lowest to highest), departure (earliest to latest)
  5. destination — destination (A to Z), total price (lowest to highest), departure (earliest to latest), duration (shortest to longest)
  6. origin — origin (A to Z), total price (lowest to highest), departure (earliest to latest), duration (shortest to longest)

The cheapest fare used for each itinerary in case multiple fare output (BrandedFares)

"default" sorting used by default

5Cabin Filter
  1. Y — for COACH and PREMIUM-COACH only
  2. D — for BUSINESS and FIRST only

Returns all cabin types by default

6Direct Flights Only Filter

Excludes transit and transfer itineraries from results

Returns all types of itinerary by default: direct, transit and transfer (Check glossary for more information about difference between itinerary types)

Response (AirShoppingRS)

#NameDescription
1Overview info
  • Sale Currency Decimals
  • Conversion rate from filed to sale currency
2Solution
  • Unique itinerary
  • One or more price solutions for the itinerary, including:
    • For the whole journey:
      • Preferred Fare Family name or "Cheapest Fare" mark
      • Pricing for all passenger types
    • For each slice:
      • Pricing for all passenger types and for 1 of each
      • Checked baggage allowance for each passenger type
    • For each segment:
      • RBD and fare details
      • Cabin type
      • Hand luggage allowance for each passenger type
    • For each leg: included meals
    • For each fare: Penalties
3Itinerary
  • For each slice:
    • Departure airport IATA code
    • Arrival airport IATA code
  • For each segment:
    • Departure airport IATA code, terminal name and datetime
    • Arrival airport IATA code, terminal name and datetime
    • Marketing and operating carrier IATA code and flight number
    • Board description
    • Flight distance and duration
  • For each stop between legs:
    • Airport IATA code, terminal name
    • Arrival and departure datetime 
    • Ground duration
4Pricing
  • Pricing for all passengers for the whole journey:
    • Total (fares + taxes) in sale currency
    • Fare in sale and filed currencies
    • Taxes in sale currency
  • Pricing for all passengers for each slice in sale currency:
    • Total (fare + tax), Fare, Taxes
  • Breakdown for1 of each passenger type for each slice in sale currency:
    • Fare , Taxes
5RBD and fare details
  • For each segment and each passenger type:
    • Fare code
    • RBD code
    • Seats left count
    • Penalties
      • Type ()
      • Minimum and maximum penalty amount
6Checked baggage allowance
  • Checked baggage: type, weight, size, count and description
  • Special equipment: type and count
7Hand luggage allowance
8Included meals

Type and description for each leg
(Check glossary for more information about difference between journey, slice, segment and leg)

9Requested inputs
  • Passengers
  • Sale Currency
  • Fare Output Type
  • Sorting Type
  • Cabin Filter
  • Direct Flights Only Filter

Samples

v0.52 | searchFlightsJourney operation | Samples

2ADT+1CHD+1INF+Domestic+RT+DIRECT | v0.52 | searchFlightsJourney operation

Check out

OriginDestination slices

OW direct flight | SearchFlightsJourney

<Envelope xmlns="http://schemas.xmlsoap.org/soap/envelope/">
    <Header />
    <Body>
        <AirShoppingRQ xmlns="http://www.iata.org/IATA/EDIST" Version="1.0">
            <Document />
            <Party>
                <Sender>
                    <AgentUserSender>
                        <PseudoCity>S7AGN8224</PseudoCity>
                        <AgentUserID>Basic-Auth*</AgentUserID>
                    </AgentUserSender>
                </Sender>
            </Party>
            <Parameters>
                <CurrCodes>
                    <CurrCode>RUB</CurrCode>
                </CurrCodes>
            </Parameters>
            <Travelers>
                <Traveler>
                    <AnonymousTraveler>
                        <PTC Quantity="1">ADT</PTC>
                    </AnonymousTraveler>
                </Traveler>
            </Travelers>
            <CoreQuery>
                <OriginDestinations>
                    <OriginDestination>
                        <Departure>
                            <AirportCode>DME</AirportCode>
                            <Date>2023-09-26</Date>
                        </Departure>
                        <Arrival>
                            <AirportCode>OVB</AirportCode>
                        </Arrival>
                    </OriginDestination>
                </OriginDestinations>
            </CoreQuery>
        </AirShoppingRQ>
    </Body>
</Envelope>

  • No labels