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 Agreement. Use 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 first, stop 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
2Itinerary solution
  • Price solutions
3Price solution
  • Preferred Fare Family name or "Cheapest Fare" mark
  • Pricing for all passengers and the whole journey:
    • Total (fares + taxes) in sale currency
    • Fare in sale and filed currencies
    • Taxes in sale currency
  • Pricing for all passengers and each slice in sale currency:
    • Total (fare + tax), Fare and Taxes
  • Breakdown for each passenger type:
    • Total (fare + taxes) price
    • Total taxes codes, sale price, price in filed currency
    • Total fare sale price and price in filed currency
4Checked baggage allowance
  • Checked baggage: type, weight, size, count and description
  • Special equipment: type and count
5i details
  • Class of service (e.g. ECONOMY)
  • Departure airport IATA code and datetime
  • Arrival airport IATA code and datetime
  • Marketing carrier IATA code and flight number
  • Operating carrier IATA code and name
  • Board description
  • Fare code
  • RBD code
  • Seats left count
  • Flight distance and duration
6Penalty details
  • Penalty types
  • Minimum and maximum penalty amount
7On-board servicesMeal type and description for each leg
(Check glossary for more information about difference between journey, slice, segment and leg)
8Requested inputs
  • Passengers
  • Sale Currency
  • Fare Output Type
  • Sorting Type
  • Cabin Filter
  • Direct Flights Only Filter

Samples