Air Pricing by Fare Type

Public and Private (negotiated) Fares are available through Universal API.

Depending on the data source, the following types of fares can be returned:

Note: Private fares can also be redistributed, which means that a requestor can ask for private fares from another provider who has a different Pseudo City Code (PCC).

Schema

Located in Air.xsd:

How To

  1. Use the AirPriceReq with the AirPricingModifers element to request fare types.
  2. Use @FaresIndicator to indicate the fare types to be sent in the request. The enumerated values of FaresIndicator are:

    • AllFares - returns all available public, private, and net fares. This value is default for Low Fare Shopping requests on Galileo (1G) and Apollo (1V). If no value is set for FaresIndicator, the default is used, and, the default response for the provider or supplier is returned. See the Exceptions section for defaults and permitted fare types for each provider/supplier.

    • PublicFaresOnly
    • PrivateFaresOnly
    • AgencyPrivateFaresOnly
    • AirlinePrivateFaresOnly
    • NetFaresOnly
    • PublicAndPrivateFares

  3. If an account code is required for an airline or agency private fare, send a single code using AccountCodes/AccountCode @Code.

    Both the supplier's account code and the provider code must be specified. The Account Code applies to the entire journey, not to an individual flight segment. 

    If @AccountCodeFaresOnly is set to 'true', the response is restricted to fares associated to the account and/or contract code specified in the request, and only fares that apply to the specified account code is returned. If this attribute is set to 'false', the response may be relaxed to include other fare types.

    Note: An account code and a contract code can be submitted in the same request.

  4. If a contract code (Rule ID) is required for an airline or agency private fare, send one or more codes using ContractCodes/ContractCode @Code.

    Both the supplier's contract code and the provider code must be specified. The Contract Code applies to the entire journey, not to an individual flight segment.

    If @AccountCodeFaresOnly is set to 'true', the response is restricted to fares associated to the account and/or contract code specified in the request.

    Note: An account code and a contract code can be submitted in the same request.

  5. You can exclude unbundled fares.

    Unbundled fares that are identified by fare types ERU or EOU can be excluded from a response by setting the AirPricingModifiers ProhibitUnbundledFareTypes attribute to true. By default, this attribute has no value. Unbundled fares usually include only transportation (no amenities) and are completely non-refundable with no changes allowed. For ACH and RCH, the ProhibitUnbundledFareTypes attribute is ignored.

    ATPCO Unbundled Industry Fare Types for Unbundled Fares

    The following ATPCO Fare Type codes are used to determine if a fare should be excluded in instances where ProhibitUnbundeldFareTypes is set to true, or, @ProhibitUnbundledFareTypes="true"

    • EOU – Economy One-way Unbundled

    • ERU – Economy Round-Trip Unbundled

    • PFD – Economy Class Frequent Flyer Unbundled

    • EOW – Economy One Way - Unbundled Level 2

    • EOX – Economy One Way - Unbundled Level 3

    • EOY – Economy One Way - Unbundled Level 4

    • ERH – Economy Round Trip - Unbundled Level 2

    • ERX – Economy Round Trip - Unbundled Level 3

    • ERY – Economy Round Trip - Unbundled Level 4

    • PSU – Student Fare Unbundled

    • PIU – Individual Inclusive Tour Fare Unbundled

    • PGU – Group Inclusive Tour Fare Unbundled

    • PRU – Economy Promotional Unbundled

    • BRU – Business Class Unbundled

    • ZRU – Premium Economy Unbundled

  6. To redistribute a private fare, LowFareSearchReq/PointOfSale @PseudoCityCode must be populated with the three- to five-character alphanumeric Pseudo City Code (PCC) of the other travel provider. The Provider Code associated with the PCC is also required.

    Private fares can be redistributed (also known as emulation), which allows the requester to use another travel provider's Pseudo City Code (PCC). Redistribution requires a prior agreement between the requester and the other travel provider. Many private fares have redistribution coded in Category 15 and 35 to secure the private fare to a requester and a provider.

    If no PCC is supplied, the default PCC from the requester's credentials is used. If the requester is not provisioned to access the travel provider's PCC, the request will fail.

  7. The Air Pricing response indicates the fare status of each air pricing response in AirPriceRsp/AirPriceResult/AirPricingSolution/AirPricingInfo/FareInfo.

  8. The fare quote specifies the type of fare:

    Private Fares

    • For Galileo and Apollo providers, private fares are listed as “Airline private fare” or “Agency private fare”.

    • For Worldspan and Airline Content Hub, private fares are listed as "Private Fare".

    • If the fare quote is a private fare, FareInfo @PseudoCityCode indicates the Pseudo City Code (PCC).

    • For private fares with an account code, the code is returned in FareInfo/AccountCode @Code. The account code input in the request is returned in the response, regardless of whether the specific fare quote requires an account code.

    Public Fares

    • No PCC is returned if the fare quote is a public fare.

    Negotiated Fare

    • If a Negotiated (Net or Net/Selling) fare amount is returned, the NegotiatedFare attribute of FareInfo is set to "true". The negotiated fare amount can be used to calculate the yield.

    • If the total net price is available, it is returned in AirPricingSolution/AirPricingInfo/TotalNetPrice.

Exceptions

  • By default, Galileo returns all fare types.

  • While Universal API permits up to five PCCs in a single request for a redistributed private fare, Galileo supports only one PCC per request. If more than one PCC is submitted, the first PCC is processed by Galileo, and any additional PCCs are ignored.

  • If @FaresIndicator is not included in the request, Public and Private Fares are returned.

  • By default, Worldspan returns public fares only.

  • When private fares are requested, all private fares return as "Private Fare".

  • Worldspan does not support:

  • Net fares
  • Contract codes in air tariff, shop, price, and book

  • While Universal API permits up to five PCCs in a single request for a redistributed private (Secure Rate) fare, Worldspan supports only one PCC per request. If more than one PCC is submitted, the first PCC is processed by Worldspan, and any additional PCCs are ignored.

  • Worldspan supports searches for either Account Code Fares Only or public and account code fares in the same request.

  • Worldspan supports up to fifteen account codes in a single request. The account code applies to the entire trip, and cannot be applied per segment.

  • The default fare type is PublicFares, which excludes private fare options and typically reduces response times.

For a more complete list of functionality available from various ACH carriers, see ACH Carriers Functionality. Because functionality for carriers may be subject to change, always confirm functionality directly with the ACH carrier before implementation.

  • Most, but not all, Low Cost Carriers on ACH return only public fares. A warning is returned if the supplier does not support public fares.

  • ACH does not support the following types of fare requests:

  • Public fares only

  • Private fares only

  • Agency private fares only

  • Airline private fares only

  • Private fares are supported by Norwegian (DY) but they require an account code.

  • When private fares are requested, all private fares return as "Private Fare".

  • Most LCCs do not support account codes. If an account code is supported, the account code sent in the Low Fare Shopping request must also be included in the Pricing request because the account code is included in the session token of the shop response.

  • Low Cost Carriers on ACH do not support redistribution of private fares.