Air Availability Modifiers

A number of modifiers can be added to an Air Availability request to narrow the search results. The following search modifiers are available in the current release for Air Availability requests. Depending on the modifier, the request can be made at either the itinerary (booking) level using AirSearchModifiers or at the air segment level using AirLegModifiers.

 

Air Search Modifier

 Request Level

Description

Flight Type

Itinerary and Segment

Allows flights to be requested by flight type, which includes specifying non-stop, direct, or a permitted number of stops and connections.

Date and Time

Segment

Returns available flight options within a specified times or time ranges.

Carriers and Alliances

Itinerary and Segment

Requests responses only from specified carriers. Depending on the provider, responses may be exclusive to that carrier, or relaxed to include other carriers if the preferred carriers are unavailable.

Several preferred airline alliances can also be requested. All carriers within the alliance are returned.

Cabin Class

Segment

Requests availability based on the cabin class, such as Economy (Coach), Business, Premium, or First Class.

Connecting Cities

Segment

For connecting flights, allows a maximum of three city codes to be included as connections in the itinerary. A maximum of three city codes can also be specified to be excluded from the itinerary.

Booking Class

Segment

Requests based on the booking class (class of service). Also allows First Availability to be requested.

Order By

Itinerary and Segment

Allows the response to be ordered by journey time, departure time, or arrival time. The OrderBy modifier has three supported enumerations: "JourneyTime", "DepartureTime", and "ArrivalTime".

Note: Worldspan (1P) do not support the "JourneyTime" enumeration, and return a warning in the response: Order by Journey Time not supported for the requested provider.

The response is ordered by the provider, after the provider has ordered by stops and connections.

  • Galileo (1G) and Apollo (1V): Returns values sorted by time, regardless of whether the flights are non-stop or connections.
  • Worldspan: Returns a response with non-stop flights sorted by time, then connecting flights sorted by time.

Prioritization between itinerary and segment modifiers follows the general rules for other modifiers at both levels.

OrderBy is ignored by Galileo and Apollo if ReturnFirstAvailableOnly="true" is also sent in the Air Availability request, and a warning is returned: ReturnFirstAvailableOnly and OrderBy cannot be combined. ReturnFirstAvailableOnly has been used.