searchFlightsJourney operation finds flight solutions for the specified search criteria by a single request, 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.
Operation used as a first step before making booking
Moreover:
If you are not sure that the requested dates provide the best prices use searchFlightsFlex operation prior, to find suitable departure dates (works only for OneWay and RoundTrip)
To be able combine the fare families for each slice of a journey use searchFlightsBySlice operation instead (up to 9 slices in journey)
Flight numbers have already been cleared? Use flightInfo operation instead to check all available price solutions for the itinerary (also provides fare rules as optional output)
Table of contents
| Table of Contents |
|---|
Request (AirShoppingRQ)
Required inputs
Name | Description | |
|---|---|---|
| 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 |
| 2 | Passengers | List of PTC and their |
Quantity for the whole journey | |
| 3 | Itinerary |
For each slice (one slice for One Way trip, two for Round Trip and more for MultiCity. |
Check glossary |
for more info): |
|
|
|
|
Optional parameters
Name | Description |
|---|---|
| 1 |
Corporate Program credentials | To apply appropriate discounts, which depends on corporate client, agent and itinerary details.
|
Available only for Corporate Program with discount scenario or Corporate Program with cashback scenario. Use credentials that you received from our technical support. Check out Quick Start for how to get those IDs Skipping |
of Corporate Program credentials input provides receiving prices without discounts for the corporate client | ||
| 2 | Sale Currency | Choose your sale currency for prices in response:
|
|
RUB used by default
|
requested sale currency directly from the filed fare currency | ||
| 3 | Fare Output Type |
|
|
|
|
BrandedFares used by default |
3. Baggage Include - to receive fare families which include free baggage | |
| 4 | Sorting |
Type | Sorts the results based on the following values in each solution (from lowest to highest)
|
Total price of the cheapest priced solution used for each itinerary in case multiple fare output (BrandedFares) "default" sorting used by default | ||
| 5 | Cabin Type Filter |
Returns all cabin types by default |
| 6 | Direct Flights Only |
Filter |
Excludes transit and transfer itineraries from search results Returns all types of itinerary by default: direct, transit and transfer ( |
Check glossary |
for more information about difference between itinerary types) |
Response (AirShoppingRS)
#Name | Description | |
|---|---|---|
| 1 |
General |
|
| 2 | Solution |
|
|
|
|
|
|
|
|
(Check glossary for more information about difference between journey, slice, segment and leg) | ||
| 3 | Itinerary |
|
|
|
|
|
| |
| 4 | Pricing |
|
|
|
|
|
|
|
|
|
| 5 |
Penalties |
|
|
| |
| 6 | Checked baggage allowance |
| ||
| 7 | Hand luggage allowance |
|
| 8 | Included meals |
(Check glossary for more information about difference between journey, slice, segment and leg) | ||
| 9 | Requested inputs |
|
|
SamplesChildren Display
2ADT+1CHD+1INF+Domestic+RT+DIRECT | v0.52 | searchFlightsJourney operation
| Include Page | ||||
|---|---|---|---|---|
|
OW + 1xADT + Direct + S7 flight| v0.52 | searchFlightsJourney operation
| Include Page | ||||
|---|---|---|---|---|
|
Corporate Program | v0.52 | searchFlightsJourney operation
Check out
operation overview, their main purpose and use cases
references with detailed explanation of input&output parameters and possible errors
other samples
| Expand | |||||
|---|---|---|---|---|---|
| |||||
|
| Expand | |||||
|---|---|---|---|---|---|
| |||||
|
OW + 1xADT + Transit + S7 flight| v0.52 | searchFlightsJourney operation
| Include Page | ||||
|---|---|---|---|---|
|
Subsidised fare+OW + 1xSRC + Direct + S7 flight| v0.52 | searchFlightsJourney operation
| Include Page | ||||
|---|---|---|---|---|
|
Subsidised fare+RT + 1xYTR+1xCHD+1INF+ Transfer| v0.52 | searchFlightsJourney operation
| Include Page | ||||
|---|---|---|---|---|
|
1ADT+1INF with a seat+Domestic+OW+DIRECT | v0.52 | searchFlightsJourney operation
| Include Page | ||||
|---|---|---|---|---|
|
ВПД МВД | v0.52 | searchFlightsJourney operation
| Include Page | ||||
|---|---|---|---|---|
|
ВПД МО | v0.52 | searchFlightsJourney operation
| Include Page | ||||
|---|---|---|---|---|
|
1CHD+Domestic+RT+DIRECT | v0.52 | searchFlightsJourney operation
| Include Page | ||||
|---|---|---|---|---|
|