Skip Navigation

Usage

This topic includes:

AirTravelerAvail Functionality

When using Shop Across Passenger Types, you must repeat the AirTravelerAvail element for each passenger group, including the following:

  • Passenger types in the PassengerTypeQuantity element under the Code attribute field.
  • Quantities in the Quantity attribute field.

Each repetition of the AirTravelerAvail element represents a Passenger Group. Passenger Groups require the following:

  • The number of passengers within each Passenger Group must equal the number of passengers traveling.
  • Passenger types within a Passenger Group must be combinable, according to the fare rules.
  • The maximum number of Passenger Groups is four (4).
  • The maximum number of passenger types within a Passenger Group is four (4).
ClosedExample

If you have

And want to shop

Then you would use

One adult traveler

ADT and JCB passenger types
  • Group 1 = ADT
  • Group 2 = JCB

One adult traveler and one child traveler
  • Group 1 = ADT and CNN
  • Group 2 = JCB and JNN

ItinerariesPerGroup Functionality

The ItinerariesPerGroup attribute allows you to designate the minimum number of options returned for each Passenger Group. Basic rules for the ItinerariesPerGroup attribute are as follows.

  • The default value for the ItinerariesPerGroup attribute is 1.
  • The value for ItinerariesPerGroup must be between 1 and 25.

Rules regarding shopping for a specific number of Passenger Groups are as follows:

When shopping for

The maximum value you can specify for ItinerariesPerGroup is

Two passenger groups

25

Three passenger groups

16

Four passenger groups

12

 

ClosedExample

If you have

And want to shop

And want to receive

Then the ItinerariesPerGroup attribute value must be

One adult traveler

ADT and JCB passenger types

At least two ADT options and two JCB options

2

In this example, the system will return the remaining options (filling the set up to 50) for the next lowest options, regardless of the passenger group, including:

  • The two lowest ADT options.
  • The two lowest JCB options.
  • Up to 46 of the next lowest options, which can be all ADT options, all JCB options, or a combination of ADT and JCB options.

MultipleTravelerGroups

The MultipleTravelerGroups attribute GroupNumber contains an ID for each passenger group based on the sequence you enter the passenger groups in the request. For example:

Passenger Group sequence in the request

Resulting sequence number in the response

First passenger group

0

Second passenger group

1

Third passenger group

2

Fourth passenger group

3


The PrimaryGroup attribute indicates True for the passenger group that causes the response to show the itinerary as one of the lowest fares at the beginning of the list. This attribute is based on the ItinerariesPerGroup attribute entered in the request.