Air Availability by Flight Type

A number of flight type modifiers can be added to the basic Air Availability request to narrow the search results.

Schema

Located in Air.xsd:

Request

  1. Enter the minimum required data for the AvailabilitySearchReq.
  2. Request specific flight types using AirSearchModifiers/FlightType.

    3.  

    Note: If any of the following attributes are also included, they have higher precedence than RequireSingleCarrier and RequireSingleCarrier is ignored:

  3. Create flight type modifiers using optional attributes of the AirSearchModifiers element. Note that some modifiers are created through a combination of attributes with specific values.

    4. Note: When searching for interline connections, online connections return until there are no more, then interline are returned (towards the bottom of the response).

    Modifier

    Attribute/Value

    Description

    Maximum Connections

    FlightType @MaxConnections

    The maximum number of connections within a segment group. This modifier can be specified at the itinerary (AirSearchModifier) or segment (AirLegModifier) level.

    Note: This attribute is not supported as a stand-alone value; it is always used in combination with other attributes.

    Maximum Stops

    FlightType @MaxStops

    The maximum number of stops within a connection. '0', '1', '2', and '3' stops are supported. This modifier can be specified at the itinerary (AirSearchModifier) or segment (AirLegModifier) level.

    Note: MaxStops is mutually exclusive with non-stop flights. If a non-stop flight option is requested, any UI feature for Maximum Stops should be disabled.

    Single Carrier

    FlightType @RequireSingleCarrier

    Requires a single carrier between Origin and Destination. This modifier can be specified at the itinerary (AirSearchModifier) or segment (AirLegModifier) level.

    Note: This attribute is not supported as a stand-alone value; it is always used in combination with other attributes.

    Non-Stop Flights Only

    • FlightType @RequireSingleCarrier set to 'true'

    • FlightType @MaxConnections set to '0'

    • FlightType @MaxStops set to '0'

    Returns only non-stop flights/price options.

    Notes:

    • A non-stop flight request is mutually exclusive from a request for Maximum Stops (MaxStops) is mutually exclusive with non-stop flights. If a Maximum Stop option is requested, any UI feature for Non-Stop Flights Only should be disabled.
    • If a request has a flight type other than non-stop, a warning message is returned in the response.

    Non-Stop and Direct Flights Only

    • FlightType @RequireSingleCarrier set to 'true'

    • FlightType @MaxConnections set to '0'

    • FlightType @MaxStops set to '1'

    Returns non-stop and direct flights/price options. Direct flights make an intermediate stop with no plane change.

    Notes:

    • A non-stop flight request is mutually exclusive from a request for Maximum Stops (MaxStops) is mutually exclusive with non-stop flights. If a Maximum Stop option is requested, any UI feature for Non-Stop and Direct Flights Only should be disabled.
    • If a request has a flight type other than non-stop, a warning message is returned in the response.

    Include Online (Same Carrier) Connections

    • FlightType @RequireSingleCarrier set to 'true'

    • FlightType @MaxConnections set to '1'

    • FlightType @MaxStops set to '1'

    Returns only non-stop, direct and single online connection solutions.

    Note: Double and triple connections may be returned in a response, if applicable.

    Include Interline Connections

    • FlightType @RequireSingleCarrier set to 'false'

    • FlightType @MaxConnections set to '1'

    • FlightType @MaxStops set to '1'

    Permits connecting flights from multiple carriers to be returned. Non-stop or direct flights can also be returned, as they are within the parameters of the maximum stops and connections.

    Maximum Connection Time

    MaxConnectionTime

    The maximum amount of time (in minutes) that a solution can contain for connections between flights.

    Note: Not currently supported by Universal API.

    Maximum Solutions

    MaxSolutions

    The maximum number of solutions to be returned in the response.

    Note: Ignored in the Availability request in Universal API. The number of solutions returned is based on the provider, and any contracts between the provider and the agency or travel provider.

    Distance Type

    DistanceType   

    Preferred unit of distance in Miles or Kilometers.

    Allow Change of Airport

    AllowChangeOfAirport   

    Note: Not currently supported by Universal API.

    Include Flight Details

    IncludeFlightDetails

    Note: Not currently supported by Universal API.

    Prohibit Overnight Layovers

    ProhibitOvernightLayovers

    Note: Not currently supported by Universal API.

    Note: RequireSingleCarrier, MaxStops, and MaxConnections attributes are ignored when they are sent in the request. If MaxStops and MaxConnections are included, Universal API returns the warning message - "MaxConnections and MaxStops are not supported" in the AvailabilitySearchRsp.

Response

A standard Air Availability response returns flight options that have been filtered for the requested parameters. If no flight type modifiers are added to a search request, the default response returns all (Any) flight types.

Exceptions

  • Galileo supports only Change of Airport for the type of stop.
  • When a modifier is used in both SearchAirLeg and AirSearchModifiers, the Segment level takes precedence over the Itinerary level.
  • Implementation of permitted connection point uses the two direct flight attributes (stop and non-stop).
  • If both a permitted connection point and either of the direct flight attributes (NonStopDirects or StopDirects) are provided in FlightType, the direct flight attributes are ignored, and a warning is returned: Direct Flight indicators ignored as Permitted Connection Point specified in request.

  • If RequireSingleCarrier is "true"; it should return NonStopDirects, Stop Directs and all the online connections in the AvailabilitySearchRsp. The interline connections should not be returned.

  • If RequireSingleCarrier is "false" or "blank"; it should return all the connections (normal availability response) in the AvailabilitySearchRsp. In the normal availability response you can receive non-stop, direct, interline and online connections.

  • When a modifier is used in both SearchAirLeg and AirSearchModifiers, the Segment level takes precedence over the Itinerary level.
  • Implementation of permitted connection point uses the two direct flight attributes (stop and non-stop).

  • If both a permitted connection point and either of the direct flight attributes (NonStopDirects or StopDirects) are provided in FlightType, the direct flight attributes are ignored, and a warning is returned: Direct Flight indicators ignored as Permitted Connection Point specified in request.

  • If RequireSingleCarrier is "true"; it should return NonStopDirects, Stop Directs and all the online connections in the AvailabilitySearchRsp. The interline connections should not be returned.

  • If RequireSingleCarrier is "false" or "blank"; it should return all the connections (normal availability response) in the AvailabilitySearchRsp. In the normal availability response you can receive non-stop, direct, interline and online connections.

  • In Worldspan (1P), by default, only public fares are returned.

    • Worldspan supports the following flight types:

  • All Flights – Type A
  • Direct Flights Only – Type B
  • Non-stop Direct Flights only – Type C
  • Online Connection Flights only – Type D
  • Stop Direct Flights only – Type E

    • Worldspan also supports :

  • Single interline connections - Type A
  • Double interline connections - Type A
  • Single online connections - Type D
  • Double online connections - Type D

    • A specific combination of attributes in Universal API must be sent in the request to match the specific Worldspan flight type desired. The following table shows the Type combinations, reading down each column, from A to E.

    Universal API Indicator Worldspan Flight Type ID
      A B C D E
    NonStopDirects true true true true false
    StopDirects true true false true true
    SingleOnlineCon true false false true false
    DoubleOnlineCon true false false true false
    TripleOnlineCon false false false false false
    SingleInterlineCon true false false false false
    DoubleInterlineCon true false false false false
    TripleInterlineCon false false false false false

    If an invalid combination is submitted, Universal API defaults to Flight Type ID A.

ACH does not support Air Availability.

RCS does not support Air Availability.