AirPrice Full Payload API Reference

POST

price/offers/buildfromproducts

Base path:

Pre-production https://api.pp.travelport.com/11/air/

Production https://api.travelport.com/11/air/

Related Content: Air Pricing Guide, AirPrice Reference Payload API Reference

The AirPrice API confirms pricing on air search results. While air pricing is generally an optional but recommended step, it is required for low cost carriers and some NDCClosed New Distribution Capability, an XML standard for exchanging data that supports airlines in distributing their content directly to online travel agencies. See the NDC Guide. carriers.

This API reference documents the full payloadClosed In the JSON APIs, an API call that sends all details of the flight/s to be shopped, priced, added to the workbench, etc. instead of sending a reference to an offer in a previous API response. request, which sends full itineraryClosed The entire trip on a booking, including all flights on all legs. Also called a journey. details without a reference to any previous search. This request can be used to price an itinerary returned from the Search API or from a non-Travelport source.

The AirPrice full payload request is supported for NDC on only the following carriers: AA, UA, QF. See the NDC Guide for details.
In AirPrice 24.11.36 and later, for AA only, the response returns upsellsClosed A fare presented along with the base fare as a higher level of service, usually a branded fare. Returned if filed by the carrier and requested with maxNumberOfUpsellsToReturn in the Search request. for NDC content by default. See the NDC Upsells example below. NDC only; the AirPrice full payload response does not return upsells for GDSClosed Global Distribution System. A GDS aggregates and distributes air, hotel, and car rental content such as schedules, fares, and upsells. In the JSON APIs, GDS content is distributed from Travelport. content.

Request

Also see Authorization and Common Headers.

Query Parameters

None.

Request Body

Basic AirPrice Request - Full Payload

Object

Description

Required/Optional

OfferQueryBuildFromProducts

Top level object.

Includes BuildFromProductsRequest and FareRuleType.

Required

lowFareFinderInd

 

Boolean. Provides pricing flexibility around class of service. If not sent, or sent with false, the response returns fares only in the requested class of service. Supported values:

  • true: Returns the lowest fares available in any class of service available, which may not be the same as the requested class.
  • false: Provides fares for only the specified class of service. Default.

Can be sent with CabinPreference below to return the lowest fare in the requested cabin.

Note that when requesting brandClosed An upgrade from the base fare that includes certain features in the price, such as wifi or seat selection. Features included in a brand are specified in the brand attributes (BrandAttributes object). attributes with lowFareFindInd set to true, AirPrice uses only the brand tier (and any other pricing modifiers) to find the lowest fare within a brand tier regardless of class of service.

Optional

returnBrandedFaresInd

 

Return brand attributes for branded fares. See Brand Pricing in the Air Pricing Guide.

Supported values:

  • true: Returns brand attributes.
  • false: Does not return brand attributes. Default.

Optional

validateInventoryInd

Boolean. Set to true to verify availability for the requested number of passengers in a specific class of service at the time of the price request. If sent with false or not sent, AirPrice may return upsell offers with no availability in the requested class of service. If there are fewer seats than requested passengers available in that class of service, AirPrice does not return any offers and instead returns the error message BOOKING CLASS/PREFERENCE NOT AVAIL CHECK AVAILABILITY. This reduces failures at the Add Offer and Workbench Commit steps.

Supported in both the reference and full payload responses. GDS only; not supported for NDC, as NDC carriers already validate inventory at pricing.

Supported values:

  • true: Checks for availability in the requested class of service.
  • false: Checks only for general seat availability on the flight, not a specific class of service. Default.

Optional; default is false

reCheckInventoryInd

Boolean. Set to true to verify availability for the requested number of passengers in a specific class of service at the time of the price request. This indicator causes AirPrice to book the seats and then release them. If any or all segments are not bookable, AirPrice returns the message The air segments are not bookable along with the dates and city pairs of the segments that are not bookable, per the following example. This indicator can help reduce sell failures at bookingClosed A confirmed reservation with the carrier. A held booking is a reservation that has not yet been ticketed. The terms booking and reservation are interchangeable. by alerting of insufficient availability.

Supported only in the full payload request.

Supported values:

  • true: Books and then releases the requested number of seats in the requested class of service.
  • false: Checks only for general seat availability on the flight, not a specific class of service. Default.
Because this indicator temporarily affects seat availability, recommended best practice is to use validateInventoryInd above instead.
To cause AirPrice to perform the same check for connecting flights, you can send both reCheckInventory=true and SpecificFlightCriteria/boundFlightsInd=true per below for any flight segmentClosed A flight or flights under one flight number. One flight equals one segment. A segment could have multiple flights if the flight number remains the same, which happens if a flight makes a stop without changing planes. with a connecting flight.
{
 "OfferListResponse": {
  "@type": "OfferListResponse",
  "transactionId": "04ec9290-06da-4eb6-bb3c-b09563cabd96",
  "Result": {
   "@type": "Result",
   "Error": [
    {
     "@type": "ErrorDetail",
     "StatusCode": 200,
     "Message": "BOOKING CLASS/PREFERENCE NOT AVAIL CHECK AVAILABILITY"
    }
   ]
  },
  "Identifier": {
   "value": "04ec9290-06da-4eb6-bb3c-b09563cabd96_PC"
  }
 }
}

Other errors may be returned:

  • 0 AVAIL/WL CLOSED

  • UNABLE - CLASS DOES NOT EXIST FOR THIS FLIGHT

  • UNABLE - FLIGHT NOT FOUND IN VENDOR SYSTEM

  • FLIGHT NOT FOUND - CHECK AVAILABILITY

Some airlines have revenue management applications that monitor for high volumes of ‘sell/ignore’ transactions for inventory.
Regardless of pricing results, air fares and inventory are only guaranteed by airlines when ticketed and paid for.

Optional; default is false

FareRuleType

Returns fare rules in the price response. Use not recommended; send the Standalone Fare Rules request instead.

Optional; use not recommended

BuildFromProductsRequest

Top level object.

Includes PricingModifiersAir, PassengerCriteria, and ProductCriteriaAir.

Required

PricingModifiersAir

Optional pricing modifiers. See the PricingModifiersAir table below.

Optional

PassengerCriteria

Array. Defines the type of passenger/s on the itinerary.

Send one PassengerCriteria for each passenger type code (PTCClosed Passenger Type Code, used to categorize travelers. The most common PTCs are adult (ADT), child (CNN), and infant (INF). You can request a maximum of 9 passengers in one Search request.).

May include optional CustomerLoyalty.

AirPrice supports up to 9 total passengers across all PTCs.

Required

passengerTypeCode

String. The passenger type code for the passengers on the itinerary. Common PTCs are:

  • ADT: adult
  • CHD: child of unknown age (see Notes on PTC and age below)
  • CNN: child when age is known
  • INF: infant without a seat
  • INS: infant with a seat
  • UNN: unaccompanied child

See Downloads to download a full list of PTCs.

When running a multiple passenger request for NDC on Qantas, Qantas supports only these PTCs: ADT, CHD, CNN, INF. Sending any other PTC may result in an error at ticketing.

Required

number

Number. The number of passengers with this PTC. Default is 1.

Required

age

Number. The age of the passenger.

Notes on PTC and age
  • Travelport recommends that age be sent only with PTCs that require age for pricing.
  • Travelport recommends sending the PTC CNN for a child instead of CHD, in which NN is the child's age; e.g., C08, C10. Many fares cannot be quoted for code CHD.
  • The age for CNN is generally between 2 and 11 inclusive, with ADT fares returned for ages 12 and up; however, this can vary by airline and country.
  • The age for INF must be either 0 or 1.
  • In the Search and Price requests, when sending specifiedPassengerTypeCodeOnlyInd as true for a child, also send the PTC CNN along with the age of the child. (This indicator is used to return offers for only the specified PTC.)
  • During booking, date of birth is required for all child and infant PTCs (Add Traveler payload in Traveler/birthDate).

Optional

specifiedPassengerTypeCodeOnlyInd

 

Boolean. AirPrice returns pricing only for the specified PTC. This indicator sets behavior if no offers for that PTC are available:

  • true: If no fares are available for the specified PTC, returns the error "NO VALID FARE FOR INPUT CRITERIA".
  • false: If no fares are available for the specified PTC, returns fares for the default ADT (adult) PTC.
GDS only; not supported for NDC.

Optional

Default is false

CustomerLoyalty

Optional object for sending customer loyalty information, such as for a frequent flyer program.

If CustomerLoyalty is sent in the Search request, it must also be sent in the AirPrice request and the Add Traveler request. Because some carriers validate frequent traveler data through the workflow, failing to send the same CustomerLoyalty details, even if invalid, may cause a booking failure. If an invalid number is sent, the response returns the warning message M INVALID FQTV NAME OR NUMBER - {carrierClosed An airline. code} and the JSON APIs cache the invalid number to prevent a potential booking failure.

Optional

TravelerGeographicLocation

Optional object for requesting local citizen/local resident fares for Spain and associated islands.

You must also send a PTC relevant to the local resident fares; e.g., ADR for adult resident, CHR for child resident.
GDS only; not supported for NDC.

Optional

value

String. IATAClosed International Air Transportation Association, an organization that standardizes rules, regulations and fare construction principles for the international travel industry. code specifying the location relevant to the local citizen//local resident fare.

Optional

travelerGeographicLocationType

String. The type of location. Supported values are 

  • Country
  • City
  • State/Province

Optional

PaymentCriteria

Optional object to send the BIN of the credit card to be used for payment. Sending the BIN returns OB fees in the response, which are ticketing and form of payment (FOP)Closed Details for the payment to be used to pay for an offer, such as credit card information. The subsequent Add Payment step is required to charge the payment. fees, including credit card fees. Returned in an instance of Price/PriceBreakdown/Fees/Fee with a feeCode of OB.

Includes IssuerIdentificationNumber.

Optional

IssuerIdentificationNumber

String, 6 to 8 byte number. Send the BIN of the credit card to be used for payment.

Required if PaymentCriteria sent

ProductCriteriaAir

Top level object for itinerary details.

Includes SpecificFlightCriteria and CabinPreference.

Required

SpecificFlightCriteria

Array. Each instance sends details for each segment on the itinerary to price.

Required

carrier

String. IATA code of airline carrier for flight.

Required

flightNumber

String. Flight number assigned by airline.

Required

departureDate

String. Departure date of flight in YYYY-MM-DD format (e.g., departureDate="2024-12-06")

Required

departureTime

String. Departure time of flight. HH:MM:SS (24-hour) format (e.g., departureTime="18:00").

Required

arrivalDate

String. Arrival date of flight in YYYY-MM-DD format.

Required

arrivalTime

String. Arrival time of flight in HH:MM:SS (24-hour) format.

Required

from

String. IATA airport code of departure.

Required

to

String. IATA airport code of arrival.

Required

cabin

String. Cabin class to price.

Required

classOfService

String. Class of service to price.

Required

brandTier

 String. The brand tier to price, if brand tier pricing is desired. Supported only in the full payload request. Optional.

Optional

segmentSequence

Sequence of this segment on the legClosed The flight or connecting flights between one origin and destination pair. For example, on a round-trip flight, LAX > MSP could be the first leg (aka outbound leg) and MSP > DEN > LAX could be the second leg (aka inbound leg). The JSON APIs use the term product (see below) to represent one leg of the itinerary., starting with 0 for the first segment on the leg. A segment is one flight with the same flight number.

Optional

AvailabilitySourceCode

Recommended to send in the full payload request.

Supported values and definitions for AvailabilitySourceCode are as follows:

  • A: AVS (availability and schedules)
  • B: Travelport cache
  • C: AVS
  • D: Direct Access
  • E: Travelport cache
  • F: Travelport cache
  • G: Travelport cache
  • H: Travelport cache
  • I: Travelport cache
  • K: Travelport cache
  • L: Last seat availability
  • M: Unknown source
  • O: Travelport cache
  • P: Travelport cache
  • Q: Travelport cache
  • S: Seamless
  • T: Travelport cache
  • U: Unknown source
  • X: Customer reusing availability data from customer cache (data originally obtained from Travelport)
  • Y: Customer reusing data obtained from another system (e.g., another GDS) (data may be fresh or stored in customer cache)
  • Z: Customer sold from e-streamed data stored in customer cache

Optional but recommended

boundFlightsInd

Boolean. To cause AirPrice to perform a sell/ignore availability check on connecting flight/s as well as the initial flight on a leg, when sending reCheckInventoryInd=trueper above, also send boundFlightsInd=true for any flight segment that has a connecting flight. (Note that recommended best practice is to use validateInventoryInd instead of reCheckInventoryInd.)

GDS only; not supported for NDC.

The following example request is for a round trip itinerary with connecting flights both ways. It sends

  • reCheckInventoryInd=true

  • boundFlightsInd=true for the first flight segment on the outbound/departure leg

  • boundFlightsInd=true for the first flight segment on the inbound/return leg

Both segments have a segmentSequence value of 0and connect to another flight segment. 

{
 "OfferQueryBuildFromProducts": {
  "lowFareFinderInd": "false",
  "returnBrandedFaresInd": "false",
  "reCheckInventoryInd": true,
  "validateInventoryInd": "true",
  "BuildFromProductsRequest": {
   "@type": "BuildFromProductsRequestAir",
   "PassengerCriteria": [
    {
     "passengerTypeCode": "ADT",
     "number": 1,
     "age": 24
    }
   ],
   "ProductCriteriaAir": [
    {
     "SpecificFlightCriteria": [
      {
       "@type": "SpecificFlightCriteria",
       "carrier": "FJ",
       "flightNumber": "910",
       "departureDate": "2023-10-16",
       "departureTime": "13:45:00",
       "arrivalDate": "2023-10-16",
       "arrivalTime": "19:25:00",
       "from": "SYD",
       "to": "NAN",
       "cabin": "Economy",
       "classOfService": "V",
       "segmentSequence": "0",
       "boundFlightsInd": true
      },
      {
       "@type": "SpecificFlightCriteria",
       "carrier": "FJ",
       "flightNumber": "810",
       "departureDate": "2023-10-16",
       "departureTime": "21:40:00",
       "arrivalDate": "2023-10-16",
       "arrivalTime": "12:55:00",
       "from": "NAN",
       "to": "LAX",
       "cabin": "Economy",
       "classOfService": "V",
       "segmentSequence": "1"
      }
     ]
    },
    {
     "SpecificFlightCriteria": [
      {
       "@type": "SpecificFlightCriteria",
       "carrier": "FJ",
       "flightNumber": "811",
       "departureDate": "2023-10-21",
       "departureTime": "23:55:00",
       "arrivalDate": "2023-10-23",
       "arrivalTime": "05:45:00",
       "from": "LAX",
       "to": "NAN",
       "cabin": "Economy",
       "classOfService": "T",
       "segmentSequence": "0",
       "boundFlightsInd": true
      },
      {
       "@type": "SpecificFlightCriteria",
       "carrier": "FJ",
       "flightNumber": "911",
       "departureDate": "2023-10-26",
       "departureTime": "09:00:00",
       "arrivalDate": "2023-10-26",
       "arrivalTime": "11:45:00",
       "from": "NAN",
       "to": "SYD",
       "cabin": "Economy",
       "classOfService": "T",
       "segmentSequence": "1"
      }
     ]
    }
   ]
  },
  "FareRuleType": "null"
 }
}

Optional

CabinPreference

Array. Requests a fare based on the cabin class. Only one cabin preference type is allowed per request, but there is no limit to the number of cabins that can be sent.

Optional

type

String. The type of cabin preference. Supported values are (no default):

  • Permitted: Searches for ONLY the specified class or classes. If that class is not available, the response does not return any offers.
  • Preferred: Searches for the specified class or classes, but will return lower classes if the specified class is not available.
  • PreferredWithUpgrade: Searches for the specified class or classes, and will return higher classes if the specified class is not available.

Required if CabinPreference sent

cabins

String. A space-delimited list of cabins. Supported values are (no default):

  • Economy
  • PremiumEconomy
  • Business
  • First
  • PremiumFirst

Required if CabinPreference sent

CustomResponseModifiersAir

Object. Sends additional modifiers.

May include BrandAttributeInclusion.

Optional

excludeUnbundledFaresInd

 
GDS only, not supported for NDC.

Boolean. Sets whether to return unbundled fares:

  • true Does not return unbundled fares in the response.

  • false: Returns unbundled and bundled fares as available. Default.

Optional

Default is false

includeFlightAmenitiesInd

Boolean. Indicator to return flight amenities from ATPCOClosed Airline Tariff Publishing Company, a company that collects and distributes fare data for the airline and travel industry. RouteHappy data:

  • true: Includes amenities in the response if available.

  • false or not sent: Amenities not returned in response.

If requested, amenities are returned in ReferenceListAmenity.

AirPrice 24.11.38.1 and later.

Optional

BrandAttributeInclusion

Object. Supports returning only information about the brand attributes specified in Classification below and does not return any other brand attributes for those fares. The specified brand attributes returned may be included, chargeable, or not offered.

Optional

Classification

String. Send one or more of the following values to return information about only the specified attributes. Fares may include other attributes but information about them is not returned. Supported values:

  • CarryOn
  • Refund
  • Meals
  • Rebooking
  • CheckedBag
  • SeatAssignment
  • WiFi

May include AdditionalClassification.

Required if BrandAttributeInclusion sent

AdditionalClassification

String. Can be sent to filter out the specified additional brand attributes. Supported values:

  • ChauffeurTransfer
  • ExtraLegroom
  • InFlightEntertainment
  • LoungeAccess
  • PriorityBaggage
  • PriorityBoarding
  • PriorityCheckIn
  • PrioritySecurity
  • PriorityServices
  • MileageAccrual
  • Upgrades
  • USB

Optional

PricingModifiersAir (optional pricing modifiers)

Add one or more optional pricing modifiers. All pricing modifiers are in OfferQueryBuildFromCatalogProductOfferings/BuildFromCatalogProductOfferingsRequest/PricingModifiersAir.

Object

Description

Required

PricingModifiersAir

Object for optional journey modifiers.

Optional

includeSplitPaymentInd

AirPrice 24.11.31 and later, reference payloadClosed In the JSON APIs, an API call that sends identifers referring to a previous response for the itinerary to be shopped, priced, added, etc. instead of full itinerary details. only. GDS only, not supported for NDC.

Boolean. Send as true when pricing a split ticketing itinerary. which includes two one-wayClosed An itinerary with a single destination; e.g., LHR > CDG. offers.

The AirPrice request must send offers that are identified in the Search response with CombinabilityCode j0; the value j0 identifies those offers as one-way outbound and one-way inbound split ticketing offers. A combination of j0 and any non-j0 value offerClosed In the JSON Search APIs, an offer is a product available at a specific price under a set of terms and conditions. An offer includes the flight or connecting flights for one leg of the itinerary, plus a service level that includes the cabin class and any fare codes that may apply. At booking, the selected offer from the Search response - including the flight/s, service level, price, terms and conditions, and brand if applicable - is converted into a single Offer object that is subsequently returned for that booking. returns the error message Split Pricing functionality not supported for this combination.

Split ticketing is available only for customers specifically provisioned for split ticketing. Split ticketing returns one-way outbound and one-way inbound fares in addition to round-tripClosed An itinerary in which travel goes to a single destination and returns to the origin. E.g., LHR > CDG and CDG > LHR. offers. Split ticket offers are identified with a CombinabilityCode of j0. If your account is not configured for split ticketing, sending includeSplitPaymentInd in the Search response returns a response without split ticket offers and the warning message User is not authorized for Split Ticketing Shop. Please contact support. GDS only, not supported for NDC.

Optional

currencyCode

String. Send the currency type to return if you want to override the default currency specified with your PCCClosed Pseudo city code. A travel provider's identification code for the JSON APIs, provisioned from Travelport. Used to determine access and other settings in the JSON APIs for your company..

For a list of currency codes, see the Universal API Reference Data file linked from Tools.

Optional

SellCity

GDS only, not supported for NDC.

String. The IATA location code for the city. Overrides the sell city of the requester to specify an alternate sale location and return pricing based on that location.

Note that the response returns pricing in the local currency for the specified sell city, not the currency for which your PCC is provisioned.

Optional

TicketCity
GDS only, not supported for NDC.

String. The IATA location code for the city. Overrides the ticketing city of the requester to specify an alternate ticket location and return pricing based on that location.

Note that the response returns pricing in the local currency for the specified ticket city, not the currency for which your PCC is provisioned.

Optional

TicketingPCC
GDS only, not supported for NDC.

String, 2-10 characters supported. Overrides the ticketing PCC associated with your account to specify an alternate PCC and return pricing based on that PCC. (PCC is the pseudo city code; a travel provider's identification code for the JSON APIs, provisioned from Travelport.)

Optional

PricingPCC
GDS only, not supported for NDC.

String, 2-10 characters supported. Use to send a faring PCC for which a selective access or code group agreement exists between that PCC and the PCC associated with your account. The following combinations of PricingPCC and FareSelection/fareType=PrivateFaresOnly (see immediately below) return results as follows:

  • PricingPCC sent and PrivateFaresOnly not requested: If a selective access or group agreement exists, both public and private faresClosed Special air fares negotiated by agencies. Private fares may use account names, account codes, contract codes, or corporate IDs. (if available) are returned for the requesting and providing PCC.

  • PricingPCC sent and PrivateFaresOnly not requested: If no selective access or group agreement exists, only public fares are returned.

  • PricingPCC sent and PrivateFaresOnly is requested: If a selective access or group agreement exists that allows private fare access, private fares (if available) are returned for the requesting and providing PCC.

  • PricingPCC sent and PrivateFaresOnly is requested: If a selective access or group agreement exists but does not allow private fares access, or if no agreement exists, an error is returned.

Optional

ManualFareAdjustment

AirPrice 24.11.37 and later; not supported for Standalone Price.
GDS only, not supported for NDC.

Send to manually adjust the base fare amount on all fares for a specific PTC. You can increase or decrease the base fare by either an amount or a percentage.

Send with @type value ManualFareAdjustmentDiscount to decrease the base fare. Send with @type value ManualFareAdjustmentIncrease to increase the fare.

If the PCC currency and the country of origin currency are different, then the amount or percentage is applied to the filed amount base fare that is converted into the PCC currency.

The following PricingModifiersAir excerpt sends one instance of ManualFareAdjustment that discounts the ADT fare by 20%, and another instance that increases the CHD fare by the amount of 50. 

 ...
  "PricingModifiersAir": {
    "@type": "PricingModifiersAir",
    "SellCity": "NYC",
    "TicketCity": "SFO",
    "ManualFareAdjustment": [
     {
      "@type": "ManualFareAdjustmentDiscount",
      "passengerTypeCodes": [
       "ADT"
      ],
      "AmountPercent": {
       "@type": "AmountPercentPercent",
       "Percent": 20
      }
     },
     {
      "@type": "ManualFareAdjustmentIncrease",
      "passengerTypeCodes": [
       "CHD"
      ],
      "AmountPercent": {
       "@type": "AmountPercentAmount",
       "Amount": {
        "value": 50
       }
      }
     }
    ]
   },
...

 

Optional

passengerTypeCodes

Send the PTC or PTCs to be increased or decreased. This increases or decreases the fare for all passengers with the PTC/s.

Required if ManualFareAdjustment is sent

AmountPercentPercent

Send to adjust the base fare for the specified PTC/s by the percentage sent in Percent as follows:

Percent: Send percentage of the base fare to be decreased or increased, up to two decimal places. For example, the value 20.5 would either increase (when sent in @type ManualFareAdjustmentIncrease) or decrease (when sent in @type ManualFareAdjustmentDiscount) the base fare by 20.5%.

Either AmountPercentPercent or AmountPercentAmount is required if ManualFareAdjustment is sent

AmountPercentAmount

Send to adjust the base fare for the specified PTC/s by the amount sent in Amount as follows:

Amount: Send the amount value to either increase or decrease the base fare, up to two decimal places. For example, the value 14.75 for a base fare in the currency USD would either increase (when sent in @type ManualFareAdjustmentIncrease) or decrease (when sent in @type ManualFareAdjustmentDiscount) the base fare by $14.75.

Either AmountPercentPercent or AmountPercentAmount is required if ManualFareAdjustment is sent

FareSelection

Object. Requests the return of fare types including private fares (negotiated), public fares (published), or net fares (consolidator fares, or any negotiated wholesale price that is further marked up for sale to customers).

Optional

fareType

String. Supported values:

The response identifies the type of fare returned for each Product in PassengerFlight/FlightProduct @fareType. Possible values in the response are AirlinePrivateFare, AgencyPrivateFare, NetFare, or PublicFare.

Includes FareSelectionDetail.

Optional

validatingCarrier

IATA code for a carrier to override the default validating carrier.

Optional

FareSelectionDetail

Object to request fares with specific restrictions.

Not supported for NDC. No NDC content is returned if any of the following are sent with true.

The response does not currently return any indicators about these conditions.

Optional

prohibitAdvancePurchaseFaresInd

 Boolean. true prevents the return of fares that require advance purchase. Default is false.

Optional

prohibitMaxStayFaresInd

Boolean. true prevents the return of fares that require a maximum stay. Default is false.

Optional

prohibitMinStayFaresInd

 Boolean. true prevents the return of fares that require a minimum stay. Default is false.

Optional

refundableOnlyInd

 Boolean. true prevents the return of fares that are not fully refundable. Default is false.

Optional

OrganizationInformation

 

Object.

Includes OrganizationIdentifier.

Optional

OrganizationIdentifier

 

Array. Send one or more account codes to return negotiated fares for your PCC.

The response returns an instance of TermsAndConditions/OrganizationInformation/OrganizationIdentifier for each account code sent.

AirPrice 23.11.27.1 and later. With this update, when FareSelection/fareType is set to PrivateFaresOnly and an account code is sent in OrganizationIdentifier, AirPrice ignores the account code. Instead, AirPrice returns any private fares available for that market and a booking code for your PCC. This prevents the return of an error message when no specific fare has been filed for that account code.

Optional

organizationCodeType

String.

Always send with a value of Account.

Required with OrganizationIdentifier

value

String. The account code to apply.

Required with OrganizationIdentifier

supplier

String. The IATA code for the airline on which the account code is applicable.

Required with OrganizationIdentifier

accountCodeFaresOnlyInd
AirPrice 23.11.29 and later. GDS only; not supported for NDC. Not supported in Standalone Price.

Boolean. Optional indicator to limit the fares returned to only fares filed for that account code. Send set to true, along with one or more account codes in OrganizationIdentifier/value per above. If sending multiple account codes, send each instance with accountCodeFaresOnlyInd set to true. If not sent the default is false.

  • If an account code is sent without accountCodeFaresOnlyInd set to true, the response includes any fares filed for that account code plus fares that are not specific to the account code.

  • If accountCodeFaresOnlyInd is sent with true and no account code, the indicator is ignored and the response returns all fares and the following warning message: accountCodeFaresOnlyInd set to true requires an account code to be specified in the request.

Note the following when also requesting private fares (FareSelection/fareType=PrivateFaresOnly):

  • PrivateFaresOnly and account code: Private fare is returned.

  • PrivateFaresOnly and account code and accountCodeFaresOnlyInd=true: Private fare specific to that account code is returned if available. If no account fare exists an error message is returned.

Note the following when also requesting net fares (FareSelection/fareType=NetFaresOnly):

  • NetFaresOnly along with Account code: Net Fare will be returned

  • NetFaresOnly and account code and accountCodeFaresOnlyInd=true: Any net fare specific to that account code is returned if available. If no account fare exists an error message is returned.

Optional

TaxExemption

AirPrice 23.11.25 and later.
GDS only, not supported for NDC.

Marks as tax exempt either all taxes, only specific tax codes, or all taxes in specific countries.

Send either allTaxesExemptInd orthe key value pairs countries and taxCodes per below.

TaxExemption supports up to nine values for countries, or nine values for taxCodes, or up to nine values in countries and taxCodes combined.

If sent, the response returns any exempt taxes with exemptInd as true and the value as 0.

Optional

countries

Array. One or more two-letter alphanumeric codes for the countries in which the taxCodes sent are tax exempt.

Optional

taxCodes

Array. One or more two-letter alphanumeric tax codes to mark as exempt.

Optional

allTaxesExemptInd

Boolean. Send with true to mark all taxes in the response as exempt. Do not send if false; instead, use countries and taxCodes to specify which taxes to exempt.

Optional

Response

The AirPrice response is the same for both reference and full payload requests. See the AirPrice Reference Payload API Reference for the response table.

See the Air Pricing Guide for response layout diagrams and description.

Example Request

For additional examples and scenarios, download the developer toolkits and see Using Postman and Developer Toolkits.

The following round-trip full payload request includes the optional CustomerLoyalty object for sending frequent traveler details. 

{
 "OfferQueryBuildFromProducts": {
  "lowFareFinderInd": "",
  "returnBrandedFaresInd": "true",
  "reCheckInventoryInd": "",
  "validateInventoryInd": "",
  "BuildFromProductsRequest": {
   "@type": "BuildFromProductsRequestAir",
   "PassengerCriteria": [
    {
     "passengerTypeCode": "ADT",
     "number": 1,
     "age": 24,
     "CustomerLoyalty": [
      {
       "supplier": "1925825570",
       "cardHolderName": "MEMBER LOYTEST"
      }
     ]
    }
   ],
   "ProductCriteriaAir": [
    {
     "SpecificFlightCriteria": [
      {
       "@type": "SpecificFlightCriteria",
       "carrier": "UA",
       "flightNumber": "532",
       "departureDate": "2024-03-12",
       "departureTime": "06:00:00",
       "arrivalDate": "2024-03-12",
       "arrivalTime": "09:30:00",
       "from": "DEN",
       "to": "ORD",
       "classOfService": "P",
       "segmentSequence": "0",
       "ContentSource": "NDC"
      }
     ]
    },
    {
     "SpecificFlightCriteria": [
      {
       "@type": "SpecificFlightCriteria",
       "carrier": "UA",
       "flightNumber": "532",
       "departureDate": "2024-03-26",
       "departureTime": "06:00:00",
       "arrivalDate": "2024-03-26",
       "arrivalTime": "09:30:00",
       "from": "DEN",
       "to": "ORD",
       "classOfService": "P",
       "segmentSequence": "0",
       "ContentSource": "NDC"
      }
     ]
    }
   ]
  },
  "FareRuleType": ""
 }
}

The following one-way request includes the SellCity pricing modifierClosed A modifier that refines the API request based on fare and ticketing options and not the travel itself; sent in the PricingModifiersAir object. See the Air Shopping Guide for a list., supported only for GDS. 

{
 "OfferQueryBuildFromProducts": {
  "BuildFromProductsRequest": {
   "@type": "BuildFromProductsRequestAir",
   "PricingModifiersAir": {
    "@type": "PricingModifiersAir",
    "SellCity": "SYD"
   },
   "PassengerCriteria": [
    {
     "@type": "PassengerCriteria",
     "number": 1,
     "passengerTypeCode": "ADT"
    }
   ],
   "ProductCriteriaAir": [
    {
     "SpecificFlightCriteria": [
      {
       "flightNumber": "1974",
       "carrier": "UA",
       "departureDate": "2023-01-13",
       "departureTime": "07:46:00",
       "arrivalDate": "2023-01-13",
       "arrivalTime": "12:41:00",
       "from": "DEN",
       "to": "ATL",
       "classOfService": "K",
       "cabin": "Economy",
       "segmentSequence": 1,
       "brandTier": "4",
       "ContentSource": "GDS"
      }
     ]
    }
   ]
  }
 }
}

Example Response

The AirPrice response is the same for both reference and full payload requests. See the AirPrice Reference Payload API Reference for an example response without upsells.

NDC AirPrice response with upsells example

AirPrice 24.11.36 added support for returning upsells for NDC content by default in the full payload response only. NDC only; the AirPrice full payload response does not return upsells for GDS content. Supported only for NDC carrier AA. The AirPrice reference payload response does not return upsells for either GDS or NDC.

Generally, both the full and reference payload AirPrice responses return pricing specific only to the class of booking in the request; i.e., pricing of one single offer. When available, for NDC carrier AA only, the full payload response returns upsell offers along with pricing for the requested class, in ascending price order.

The example response below returns pricing on the requested offer plus two upsells for a total of three priced offers. For brevity, a third and fourth upsell were removed from this example (offers o4 and o5), so some of the reference information in ReferenceList is for those offers and does not apply.

{
 "OfferListResponse": {
  "@type": "OfferListResponse",
  "OfferID": [
   {
    "@type": "Offer",
    "id": "o0",
    "Identifier": {
     "authority": "AA",
     "value": "UEY3REU2QTBCLTNDQjctNDU5RS04Mjk3YTY3bGJ0MmJndHk1eS0xfFBGN0RFNkEwQi0zQ0I3LTQ1OUUtODI5N3wyMDI0LTA2LTI4VDA1OjIwOjUzfEFEVDpQRjdERTZBMEItM0NCNy00NTlFLTgyOTdhNjdsYnQyYmd0eTV5LTEtMTpUMXxBQXxST0U6MS41MDE2MTAyOQ=="
    },
    "ContentSource": "NDC",
    "Product": [
     {
      "@type": "ProductAir",
      "totalDuration": "PT2H1M",
      "id": "p0",
      "FlightSegment": [
       {
        "@type": "FlightSegment",
        "id": "s1",
        "sequence": 1,
        "Flight": {
         "@type": "FlightDetail",
         "duration": "PT2H1M",
         "carrier": "AA",
         "number": "2612",
         "equipment": "738",
         "id": "f1",
         "Identifier": {
          "value": "F1"
         },
         "Departure": {
          "@type": "DepartureDetail",
          "location": "DEN",
          "date": "2024-07-28",
          "time": "05:00:00"
         },
         "Arrival": {
          "@type": "ArrivalDetail",
          "terminal": "0",
          "location": "DFW",
          "date": "2024-07-28",
          "time": "08:01:00"
         }
        }
       }
      ],
      "PassengerFlight": [
       {
        "@type": "PassengerFlight",
        "passengerQuantity": 1,
        "passengerTypeCode": "ADT",
        "FlightProduct": [
         {
          "@type": "FlightProduct",
          "segmentSequence": [
           1
          ],
          "classOfService": "B",
          "cabin": "Economy",
          "fareBasisCode": "NWAUZNBV",
          "fareType": "PublicFare",
          "Brand": {
           "@type": "Brand",
           "BrandRef": "b0"
          }
         }
        ]
       }
      ]
     },
     {
      "@type": "ProductAir",
      "totalDuration": "PT2H19M",
      "id": "p1",
      "FlightSegment": [
       {
        "@type": "FlightSegment",
        "id": "s2",
        "sequence": 1,
        "Flight": {
         "@type": "FlightDetail",
         "duration": "PT2H19M",
         "carrier": "AA",
         "number": "980",
         "equipment": "321",
         "id": "f2",
         "Identifier": {
          "value": "F2"
         },
         "Departure": {
          "@type": "DepartureDetail",
          "terminal": "0",
          "location": "DFW",
          "date": "2024-07-28",
          "time": "10:23:00"
         },
         "Arrival": {
          "@type": "ArrivalDetail",
          "terminal": "N",
          "location": "ATL",
          "date": "2024-07-28",
          "time": "13:42:00"
         }
        }
       }
      ],
      "PassengerFlight": [
       {
        "@type": "PassengerFlight",
        "passengerQuantity": 1,
        "passengerTypeCode": "ADT",
        "FlightProduct": [
         {
          "@type": "FlightProduct",
          "segmentSequence": [
           1
          ],
          "classOfService": "B",
          "cabin": "Economy",
          "fareBasisCode": "NWAUZNBV",
          "fareType": "PublicFare",
          "Brand": {
           "@type": "Brand",
           "BrandRef": "b0"
          }
         }
        ]
       }
      ]
     },
     {
      "@type": "ProductAir",
      "totalDuration": "PT2H19M",
      "id": "p2",
      "FlightSegment": [
       {
        "@type": "FlightSegment",
        "id": "s3",
        "sequence": 1,
        "Flight": {
         "@type": "FlightDetail",
         "duration": "PT2H19M",
         "carrier": "AA",
         "number": "2770",
         "equipment": "321",
         "id": "f3",
         "Identifier": {
          "value": "F3"
         },
         "Departure": {
          "@type": "DepartureDetail",
          "terminal": "N",
          "location": "ATL",
          "date": "2024-07-31",
          "time": "06:01:00"
         },
         "Arrival": {
          "@type": "ArrivalDetail",
          "terminal": "0",
          "location": "DFW",
          "date": "2024-07-31",
          "time": "07:20:00"
         }
        }
       }
      ],
      "PassengerFlight": [
       {
        "@type": "PassengerFlight",
        "passengerQuantity": 1,
        "passengerTypeCode": "ADT",
        "FlightProduct": [
         {
          "@type": "FlightProduct",
          "segmentSequence": [
           1
          ],
          "classOfService": "B",
          "cabin": "Economy",
          "fareBasisCode": "QWAUUNBV",
          "fareType": "PublicFare",
          "Brand": {
           "@type": "Brand",
           "BrandRef": "b0"
          }
         }
        ]
       }
      ]
     },
     {
      "@type": "ProductAir",
      "totalDuration": "PT2H24M",
      "id": "p3",
      "FlightSegment": [
       {
        "@type": "FlightSegment",
        "id": "s4",
        "sequence": 1,
        "Flight": {
         "@type": "FlightDetail",
         "duration": "PT2H24M",
         "carrier": "AA",
         "number": "2357",
         "equipment": "321",
         "id": "f4",
         "Identifier": {
          "value": "F4"
         },
         "Departure": {
          "@type": "DepartureDetail",
          "terminal": "0",
          "location": "DFW",
          "date": "2024-07-31",
          "time": "08:25:00"
         },
         "Arrival": {
          "@type": "ArrivalDetail",
          "location": "DEN",
          "date": "2024-07-31",
          "time": "09:49:00"
         }
        }
       }
      ],
      "PassengerFlight": [
       {
        "@type": "PassengerFlight",
        "passengerQuantity": 1,
        "passengerTypeCode": "ADT",
        "FlightProduct": [
         {
          "@type": "FlightProduct",
          "segmentSequence": [
           1
          ],
          "classOfService": "B",
          "cabin": "Economy",
          "fareBasisCode": "QWAUUNBV",
          "fareType": "PublicFare",
          "Brand": {
           "@type": "Brand",
           "BrandRef": "b0"
          }
         }
        ]
       }
      ]
     }
    ],
    "Price": {
     "@type": "PriceDetail",
     "CurrencyCode": {
      "decimalPlace": 2,
      "value": "AUD"
     },
     "Base": 235,
     "TotalTaxes": 91.6,
     "TotalFees": 0,
     "TotalPrice": 326.6,
     "PriceBreakdown": [
      {
       "@type": "PriceBreakdownAir",
       "quantity": 1,
       "requestedPassengerType": "ADT",
       "Amount": {
        "@type": "Amount",
        "CurrencyCode": {
         "value": "AUD"
        },
        "Base": 235,
        "Taxes": {
         "@type": "TaxesDetail",
         "TotalTaxes": 91.6,
         "Tax": [
          {
           "taxCode": "US",
           "description": "US Transportation Tax",
           "value": 9.8
          },
          {
           "taxCode": "US",
           "description": "US Transportation Tax",
           "value": 7.8
          },
          {
           "taxCode": "XF",
           "description": "US Passenger Facility Charge",
           "value": 6.8
          },
          {
           "taxCode": "AY",
           "description": "United States Passenger Civil Aviation Security Service Fee",
           "value": 16.8
          },
          {
           "taxCode": "ZP",
           "description": "United States Flight Segment Tax Domestic",
           "value": 7.5
          },
          {
           "taxCode": "XF",
           "description": "US Passenger Facility Charge",
           "value": 6.8
          },
          {
           "taxCode": "ZP",
           "description": "United States Flight Segment Tax Domestic",
           "value": 7.5
          },
          {
           "taxCode": "XF",
           "description": "US Passenger Facility Charge",
           "value": 6.8
          },
          {
           "taxCode": "ZP",
           "description": "United States Flight Segment Tax Domestic",
           "value": 7.5
          },
          {
           "taxCode": "XF",
           "description": "US Passenger Facility Charge",
           "value": 6.8
          },
          {
           "taxCode": "ZP",
           "description": "United States Flight Segment Tax Domestic",
           "value": 7.5
          }
         ]
        },
        "Fees": {
         "@type": "FeesDetail",
         "TotalFees": 0
        },
        "Total": 326.6
       }
      }
     ]
    },
    "TermsAndConditionsFull": [
     {
      "@type": "TermsAndConditionsFullAir",
      "secureFlightPassengerDataRequiredInd": true,
      "ExpiryDate": "2024-06-28T05:20:53Z",
      "BaggageAllowance": [
       {
        "@type": "BaggageAllowanceDetail",
        "passengerTypeCodes": [
         "ADT"
        ],
        "baggageType": "FirstCheckedBag",
        "ProductRef": [
         "p0"
        ],
        "BaggageItem": [
         {
          "@type": "BaggageItem",
          "quantity": 0
         }
        ],
        "SegmentSequenceList": [
         1
        ],
        "Text": [
         "0PC",
         "CHECKED ALLOWANCE"
        ]
       },
       {
        "@type": "BaggageAllowanceDetail",
        "passengerTypeCodes": [
         "ADT"
        ],
        "baggageType": "FirstCheckedBag",
        "ProductRef": [
         "p2"
        ],
        "BaggageItem": [
         {
          "@type": "BaggageItem",
          "quantity": 0
         }
        ],
        "SegmentSequenceList": [
         1
        ],
        "Text": [
         "0PC",
         "CHECKED ALLOWANCE"
        ]
       }
      ],
      "ValidatingAirline": [
       {
        "@type": "ValidatingAirline",
        "ValidatingAirline": "AA"
       }
      ],
      "PaymentTimeLimit": "2024-06-28T23:59:00Z",
      "Penalties": [
       {
        "@type": "Penalties",
        "Change": [
         {
          "@type": "ChangeNotPermitted",
          "ProductRefs": [
           "p0",
           "p2"
          ],
          "NotPermittedInd": "true"
         }
        ],
        "Cancel": [
         {
          "@type": "CancelNotPermitted",
          "ProductRefs": [
           "p0",
           "p2"
          ],
          "NotPermittedInd": "true"
         }
        ],
        "PassengerTypeCodes": [
         "ADT"
        ]
       }
      ]
     }
    ]
   },
   {
    "@type": "Offer",
    "id": "o1",
    "Identifier": {
     "authority": "AA",
     "value": "UEY3REU2QTBCLTNDQjctNDU5RS04Mjk3aDU4aWdhOGd0cm9jei01fFBGN0RFNkEwQi0zQ0I3LTQ1OUUtODI5N3wyMDI0LTA2LTI4VDA1OjIwOjUzfEFEVDpQRjdERTZBMEItM0NCNy00NTlFLTgyOTdoNThpZ2E4Z3Ryb2N6LTUtMTpUMXxBQXxST0U6MS41MDE2MTAyOQ=="
    },
    "ContentSource": "NDC",
    "Product": [
     {
      "@type": "ProductAir",
      "totalDuration": "PT2H1M",
      "id": "p0",
      "FlightSegment": [
       {
        "@type": "FlightSegment",
        "id": "s1",
        "sequence": 1,
        "Flight": {
         "@type": "FlightDetail",
         "duration": "PT2H1M",
         "carrier": "AA",
         "number": "2612",
         "equipment": "738",
         "id": "f1",
         "Identifier": {
          "value": "F1"
         },
         "Departure": {
          "@type": "DepartureDetail",
          "location": "DEN",
          "date": "2024-07-28",
          "time": "05:00:00"
         },
         "Arrival": {
          "@type": "ArrivalDetail",
          "terminal": "0",
          "location": "DFW",
          "date": "2024-07-28",
          "time": "08:01:00"
         }
        }
       }
      ],
      "PassengerFlight": [
       {
        "@type": "PassengerFlight",
        "passengerQuantity": 1,
        "passengerTypeCode": "ADT",
        "FlightProduct": [
         {
          "@type": "FlightProduct",
          "segmentSequence": [
           1
          ],
          "classOfService": "N",
          "cabin": "Economy",
          "fareBasisCode": "NWAUZRU5",
          "fareType": "PublicFare",
          "Brand": {
           "@type": "Brand",
           "BrandRef": "b1"
          }
         }
        ]
       }
      ]
     },
     {
      "@type": "ProductAir",
      "totalDuration": "PT2H19M",
      "id": "p1",
      "FlightSegment": [
       {
        "@type": "FlightSegment",
        "id": "s2",
        "sequence": 1,
        "Flight": {
         "@type": "FlightDetail",
         "duration": "PT2H19M",
         "carrier": "AA",
         "number": "980",
         "equipment": "321",
         "id": "f2",
         "Identifier": {
          "value": "F2"
         },
         "Departure": {
          "@type": "DepartureDetail",
          "terminal": "0",
          "location": "DFW",
          "date": "2024-07-28",
          "time": "10:23:00"
         },
         "Arrival": {
          "@type": "ArrivalDetail",
          "terminal": "N",
          "location": "ATL",
          "date": "2024-07-28",
          "time": "13:42:00"
         }
        }
       }
      ],
      "PassengerFlight": [
       {
        "@type": "PassengerFlight",
        "passengerQuantity": 1,
        "passengerTypeCode": "ADT",
        "FlightProduct": [
         {
          "@type": "FlightProduct",
          "segmentSequence": [
           1
          ],
          "classOfService": "N",
          "cabin": "Economy",
          "fareBasisCode": "NWAUZRU5",
          "fareType": "PublicFare",
          "Brand": {
           "@type": "Brand",
           "BrandRef": "b1"
          }
         }
        ]
       }
      ]
     },
     {
      "@type": "ProductAir",
      "totalDuration": "PT2H19M",
      "id": "p2",
      "FlightSegment": [
       {
        "@type": "FlightSegment",
        "id": "s3",
        "sequence": 1,
        "Flight": {
         "@type": "FlightDetail",
         "duration": "PT2H19M",
         "carrier": "AA",
         "number": "2770",
         "equipment": "321",
         "id": "f3",
         "Identifier": {
          "value": "F3"
         },
         "Departure": {
          "@type": "DepartureDetail",
          "terminal": "N",
          "location": "ATL",
          "date": "2024-07-31",
          "time": "06:01:00"
         },
         "Arrival": {
          "@type": "ArrivalDetail",
          "terminal": "0",
          "location": "DFW",
          "date": "2024-07-31",
          "time": "07:20:00"
         }
        }
       }
      ],
      "PassengerFlight": [
       {
        "@type": "PassengerFlight",
        "passengerQuantity": 1,
        "passengerTypeCode": "ADT",
        "FlightProduct": [
         {
          "@type": "FlightProduct",
          "segmentSequence": [
           1
          ],
          "classOfService": "Q",
          "cabin": "Economy",
          "fareBasisCode": "QWAUURU5",
          "fareType": "PublicFare",
          "Brand": {
           "@type": "Brand",
           "BrandRef": "b1"
          }
         }
        ]
       }
      ]
     },
     {
      "@type": "ProductAir",
      "totalDuration": "PT2H24M",
      "id": "p3",
      "FlightSegment": [
       {
        "@type": "FlightSegment",
        "id": "s4",
        "sequence": 1,
        "Flight": {
         "@type": "FlightDetail",
         "duration": "PT2H24M",
         "carrier": "AA",
         "number": "2357",
         "equipment": "321",
         "id": "f4",
         "Identifier": {
          "value": "F4"
         },
         "Departure": {
          "@type": "DepartureDetail",
          "terminal": "0",
          "location": "DFW",
          "date": "2024-07-31",
          "time": "08:25:00"
         },
         "Arrival": {
          "@type": "ArrivalDetail",
          "location": "DEN",
          "date": "2024-07-31",
          "time": "09:49:00"
         }
        }
       }
      ],
      "PassengerFlight": [
       {
        "@type": "PassengerFlight",
        "passengerQuantity": 1,
        "passengerTypeCode": "ADT",
        "FlightProduct": [
         {
          "@type": "FlightProduct",
          "segmentSequence": [
           1
          ],
          "classOfService": "Q",
          "cabin": "Economy",
          "fareBasisCode": "QWAUURU5",
          "fareType": "PublicFare",
          "Brand": {
           "@type": "Brand",
           "BrandRef": "b1"
          }
         }
        ]
       }
      ]
     }
    ],
    "Price": {
     "@type": "PriceDetail",
     "CurrencyCode": {
      "decimalPlace": 2,
      "value": "AUD"
     },
     "Base": 472,
     "TotalTaxes": 109.4,
     "TotalFees": 0,
     "TotalPrice": 581.4,
     "PriceBreakdown": [
      {
       "@type": "PriceBreakdownAir",
       "quantity": 1,
       "requestedPassengerType": "ADT",
       "Amount": {
        "@type": "Amount",
        "CurrencyCode": {
         "value": "AUD"
        },
        "Base": 472,
        "Taxes": {
         "@type": "TaxesDetail",
         "TotalTaxes": 109.4,
         "Tax": [
          {
           "taxCode": "US",
           "description": "US Transportation Tax",
           "value": 18.7
          },
          {
           "taxCode": "US",
           "description": "US Transportation Tax",
           "value": 16.7
          },
          {
           "taxCode": "XF",
           "description": "US Passenger Facility Charge",
           "value": 6.8
          },
          {
           "taxCode": "AY",
           "description": "United States Passenger Civil Aviation Security Service Fee",
           "value": 16.8
          },
          {
           "taxCode": "ZP",
           "description": "United States Flight Segment Tax Domestic",
           "value": 7.5
          },
          {
           "taxCode": "XF",
           "description": "US Passenger Facility Charge",
           "value": 6.8
          },
          {
           "taxCode": "ZP",
           "description": "United States Flight Segment Tax Domestic",
           "value": 7.5
          },
          {
           "taxCode": "XF",
           "description": "US Passenger Facility Charge",
           "value": 6.8
          },
          {
           "taxCode": "ZP",
           "description": "United States Flight Segment Tax Domestic",
           "value": 7.5
          },
          {
           "taxCode": "XF",
           "description": "US Passenger Facility Charge",
           "value": 6.8
          },
          {
           "taxCode": "ZP",
           "description": "United States Flight Segment Tax Domestic",
           "value": 7.5
          }
         ]
        },
        "Fees": {
         "@type": "FeesDetail",
         "TotalFees": 0
        },
        "Total": 581.4
       }
      }
     ]
    },
    "TermsAndConditionsFull": [
     {
      "@type": "TermsAndConditionsFullAir",
      "secureFlightPassengerDataRequiredInd": true,
      "ExpiryDate": "2024-06-28T05:20:53Z",
      "ValidatingAirline": [
       {
        "@type": "ValidatingAirline",
        "ValidatingAirline": "AA"
       }
      ],
      "PaymentTimeLimit": "2024-06-28T23:59:00Z"
     }
    ]
   },
   {
    "@type": "Offer",
    "id": "o2",
    "Identifier": {
     "authority": "AA",
     "value": "UEY3REU2QTBCLTNDQjctNDU5RS04Mjk3M3BhdWs3OWxhNWVidC02fFBGN0RFNkEwQi0zQ0I3LTQ1OUUtODI5N3wyMDI0LTA2LTI4VDA1OjIwOjUzfEFEVDpQRjdERTZBMEItM0NCNy00NTlFLTgyOTczcGF1azc5bGE1ZWJ0LTYtMTpUMXxBQXxST0U6MS41MDE2MTAyOQ=="
    },
    "ContentSource": "NDC",
    "Product": [
     {
      "@type": "ProductAir",
      "totalDuration": "PT2H1M",
      "id": "p0",
      "FlightSegment": [
       {
        "@type": "FlightSegment",
        "id": "s1",
        "sequence": 1,
        "Flight": {
         "@type": "FlightDetail",
         "duration": "PT2H1M",
         "carrier": "AA",
         "number": "2612",
         "equipment": "738",
         "id": "f1",
         "Identifier": {
          "value": "F1"
         },
         "Departure": {
          "@type": "DepartureDetail",
          "location": "DEN",
          "date": "2024-07-28",
          "time": "05:00:00"
         },
         "Arrival": {
          "@type": "ArrivalDetail",
          "terminal": "0",
          "location": "DFW",
          "date": "2024-07-28",
          "time": "08:01:00"
         }
        }
       }
      ],
      "PassengerFlight": [
       {
        "@type": "PassengerFlight",
        "passengerQuantity": 1,
        "passengerTypeCode": "ADT",
        "FlightProduct": [
         {
          "@type": "FlightProduct",
          "segmentSequence": [
           1
          ],
          "classOfService": "N",
          "cabin": "Economy",
          "fareBasisCode": "NWAUZNTV",
          "fareType": "AirlinePrivateFare",
          "Brand": {
           "@type": "Brand",
           "BrandRef": "b2"
          }
         }
        ]
       }
      ]
     },
     {
      "@type": "ProductAir",
      "totalDuration": "PT2H19M",
      "id": "p1",
      "FlightSegment": [
       {
        "@type": "FlightSegment",
        "id": "s2",
        "sequence": 1,
        "Flight": {
         "@type": "FlightDetail",
         "duration": "PT2H19M",
         "carrier": "AA",
         "number": "980",
         "equipment": "321",
         "id": "f2",
         "Identifier": {
          "value": "F2"
         },
         "Departure": {
          "@type": "DepartureDetail",
          "terminal": "0",
          "location": "DFW",
          "date": "2024-07-28",
          "time": "10:23:00"
         },
         "Arrival": {
          "@type": "ArrivalDetail",
          "terminal": "N",
          "location": "ATL",
          "date": "2024-07-28",
          "time": "13:42:00"
         }
        }
       }
      ],
      "PassengerFlight": [
       {
        "@type": "PassengerFlight",
        "passengerQuantity": 1,
        "passengerTypeCode": "ADT",
        "FlightProduct": [
         {
          "@type": "FlightProduct",
          "segmentSequence": [
           1
          ],
          "classOfService": "N",
          "cabin": "Economy",
          "fareBasisCode": "NWAUZNTV",
          "fareType": "AirlinePrivateFare",
          "Brand": {
           "@type": "Brand",
           "BrandRef": "b2"
          }
         }
        ]
       }
      ]
     },
     {
      "@type": "ProductAir",
      "totalDuration": "PT2H19M",
      "id": "p2",
      "FlightSegment": [
       {
        "@type": "FlightSegment",
        "id": "s3",
        "sequence": 1,
        "Flight": {
         "@type": "FlightDetail",
         "duration": "PT2H19M",
         "carrier": "AA",
         "number": "2770",
         "equipment": "321",
         "id": "f3",
         "Identifier": {
          "value": "F3"
         },
         "Departure": {
          "@type": "DepartureDetail",
          "terminal": "N",
          "location": "ATL",
          "date": "2024-07-31",
          "time": "06:01:00"
         },
         "Arrival": {
          "@type": "ArrivalDetail",
          "terminal": "0",
          "location": "DFW",
          "date": "2024-07-31",
          "time": "07:20:00"
         }
        }
       }
      ],
      "PassengerFlight": [
       {
        "@type": "PassengerFlight",
        "passengerQuantity": 1,
        "passengerTypeCode": "ADT",
        "FlightProduct": [
         {
          "@type": "FlightProduct",
          "segmentSequence": [
           1
          ],
          "classOfService": "Q",
          "cabin": "Economy",
          "fareBasisCode": "QWAUUNTV",
          "fareType": "AirlinePrivateFare",
          "Brand": {
           "@type": "Brand",
           "BrandRef": "b2"
          }
         }
        ]
       }
      ]
     },
     {
      "@type": "ProductAir",
      "totalDuration": "PT2H24M",
      "id": "p3",
      "FlightSegment": [
       {
        "@type": "FlightSegment",
        "id": "s4",
        "sequence": 1,
        "Flight": {
         "@type": "FlightDetail",
         "duration": "PT2H24M",
         "carrier": "AA",
         "number": "2357",
         "equipment": "321",
         "id": "f4",
         "Identifier": {
          "value": "F4"
         },
         "Departure": {
          "@type": "DepartureDetail",
          "terminal": "0",
          "location": "DFW",
          "date": "2024-07-31",
          "time": "08:25:00"
         },
         "Arrival": {
          "@type": "ArrivalDetail",
          "location": "DEN",
          "date": "2024-07-31",
          "time": "09:49:00"
         }
        }
       }
      ],
      "PassengerFlight": [
       {
        "@type": "PassengerFlight",
        "passengerQuantity": 1,
        "passengerTypeCode": "ADT",
        "FlightProduct": [
         {
          "@type": "FlightProduct",
          "segmentSequence": [
           1
          ],
          "classOfService": "Q",
          "cabin": "Economy",
          "fareBasisCode": "QWAUUNTV",
          "fareType": "AirlinePrivateFare",
          "Brand": {
           "@type": "Brand",
           "BrandRef": "b2"
          }
         }
        ]
       }
      ]
     }
    ],
    "Price": {
     "@type": "PriceDetail",
     "CurrencyCode": {
      "decimalPlace": 2,
      "value": "AUD"
     },
     "Base": 528,
     "TotalTaxes": 113.6,
     "TotalFees": 0,
     "TotalPrice": 641.6,
     "PriceBreakdown": [
      {
       "@type": "PriceBreakdownAir",
       "quantity": 1,
       "requestedPassengerType": "ADT",
       "Amount": {
        "@type": "Amount",
        "CurrencyCode": {
         "value": "AUD"
        },
        "Base": 528,
        "Taxes": {
         "@type": "TaxesDetail",
         "TotalTaxes": 113.6,
         "Tax": [
          {
           "taxCode": "US",
           "description": "US Transportation Tax",
           "value": 20.8
          },
          {
           "taxCode": "US",
           "description": "US Transportation Tax",
           "value": 18.8
          },
          {
           "taxCode": "XF",
           "description": "US Passenger Facility Charge",
           "value": 6.8
          },
          {
           "taxCode": "AY",
           "description": "United States Passenger Civil Aviation Security Service Fee",
           "value": 16.8
          },
          {
           "taxCode": "ZP",
           "description": "United States Flight Segment Tax Domestic",
           "value": 7.5
          },
          {
           "taxCode": "XF",
           "description": "US Passenger Facility Charge",
           "value": 6.8
          },
          {
           "taxCode": "ZP",
           "description": "United States Flight Segment Tax Domestic",
           "value": 7.5
          },
          {
           "taxCode": "XF",
           "description": "US Passenger Facility Charge",
           "value": 6.8
          },
          {
           "taxCode": "ZP",
           "description": "United States Flight Segment Tax Domestic",
           "value": 7.5
          },
          {
           "taxCode": "XF",
           "description": "US Passenger Facility Charge",
           "value": 6.8
          },
          {
           "taxCode": "ZP",
           "description": "United States Flight Segment Tax Domestic",
           "value": 7.5
          }
         ]
        },
        "Fees": {
         "@type": "FeesDetail",
         "TotalFees": 0
        },
        "Total": 641.6
       }
      }
     ]
    },
    "TermsAndConditionsFull": [
     {
      "@type": "TermsAndConditionsFullAir",
      "secureFlightPassengerDataRequiredInd": true,
      "ExpiryDate": "2024-06-28T05:20:53Z",
      "ValidatingAirline": [
       {
        "@type": "ValidatingAirline",
        "ValidatingAirline": "AA"
       }
      ],
      "PaymentTimeLimit": "2024-06-28T23:59:00Z",
      "Penalties": [
       {
        "@type": "Penalties",
        "Cancel": [
         {
          "@type": "CancelNotPermitted",
          "ProductRefs": [
           "p0",
           "p2"
          ],
          "NotPermittedInd": "true"
         }
        ],
        "PassengerTypeCodes": [
         "ADT"
        ]
       }
      ]
     }
    ]
   },
   {
    "@type": "Offer",
    "id": "o3",
    "Identifier": {
     "authority": "AA",
     "value": "UEY3REU2QTBCLTNDQjctNDU5RS04Mjk3dWlzZ2gza3l0bG95Yi03fFBGN0RFNkEwQi0zQ0I3LTQ1OUUtODI5N3wyMDI0LTA2LTI4VDA1OjIwOjUzfEFEVDpQRjdERTZBMEItM0NCNy00NTlFLTgyOTd1aXNnaDNreXRsb3liLTctMTpUMXxBQXxST0U6MS41MDE2MTAyOQ=="
    },
    "ContentSource": "NDC",
    "Product": [
     {
      "@type": "ProductAir",
      "totalDuration": "PT2H1M",
      "id": "p0",
      "FlightSegment": [
       {
        "@type": "FlightSegment",
        "id": "s1",
        "sequence": 1,
        "Flight": {
         "@type": "FlightDetail",
         "duration": "PT2H1M",
         "carrier": "AA",
         "number": "2612",
         "equipment": "738",
         "id": "f1",
         "Identifier": {
          "value": "F1"
         },
         "Departure": {
          "@type": "DepartureDetail",
          "location": "DEN",
          "date": "2024-07-28",
          "time": "05:00:00"
         },
         "Arrival": {
          "@type": "ArrivalDetail",
          "terminal": "0",
          "location": "DFW",
          "date": "2024-07-28",
          "time": "08:01:00"
         }
        }
       }
      ],
      "PassengerFlight": [
       {
        "@type": "PassengerFlight",
        "passengerQuantity": 1,
        "passengerTypeCode": "ADT",
        "FlightProduct": [
         {
          "@type": "FlightProduct",
          "segmentSequence": [
           1
          ],
          "classOfService": "N",
          "cabin": "Economy",
          "fareBasisCode": "NWAUZRKV",
          "fareType": "AirlinePrivateFare",
          "Brand": {
           "@type": "Brand",
           "BrandRef": "b3"
          }
         }
        ]
       }
      ]
     },
     {
      "@type": "ProductAir",
      "totalDuration": "PT2H19M",
      "id": "p1",
      "FlightSegment": [
       {
        "@type": "FlightSegment",
        "id": "s2",
        "sequence": 1,
        "Flight": {
         "@type": "FlightDetail",
         "duration": "PT2H19M",
         "carrier": "AA",
         "number": "980",
         "equipment": "321",
         "id": "f2",
         "Identifier": {
          "value": "F2"
         },
         "Departure": {
          "@type": "DepartureDetail",
          "terminal": "0",
          "location": "DFW",
          "date": "2024-07-28",
          "time": "10:23:00"
         },
         "Arrival": {
          "@type": "ArrivalDetail",
          "terminal": "N",
          "location": "ATL",
          "date": "2024-07-28",
          "time": "13:42:00"
         }
        }
       }
      ],
      "PassengerFlight": [
       {
        "@type": "PassengerFlight",
        "passengerQuantity": 1,
        "passengerTypeCode": "ADT",
        "FlightProduct": [
         {
          "@type": "FlightProduct",
          "segmentSequence": [
           1
          ],
          "classOfService": "N",
          "cabin": "Economy",
          "fareBasisCode": "NWAUZRKV",
          "fareType": "AirlinePrivateFare",
          "Brand": {
           "@type": "Brand",
           "BrandRef": "b3"
          }
         }
        ]
       }
      ]
     },
     {
      "@type": "ProductAir",
      "totalDuration": "PT2H19M",
      "id": "p2",
      "FlightSegment": [
       {
        "@type": "FlightSegment",
        "id": "s3",
        "sequence": 1,
        "Flight": {
         "@type": "FlightDetail",
         "duration": "PT2H19M",
         "carrier": "AA",
         "number": "2770",
         "equipment": "321",
         "id": "f3",
         "Identifier": {
          "value": "F3"
         },
         "Departure": {
          "@type": "DepartureDetail",
          "terminal": "N",
          "location": "ATL",
          "date": "2024-07-31",
          "time": "06:01:00"
         },
         "Arrival": {
          "@type": "ArrivalDetail",
          "terminal": "0",
          "location": "DFW",
          "date": "2024-07-31",
          "time": "07:20:00"
         }
        }
       }
      ],
      "PassengerFlight": [
       {
        "@type": "PassengerFlight",
        "passengerQuantity": 1,
        "passengerTypeCode": "ADT",
        "FlightProduct": [
         {
          "@type": "FlightProduct",
          "segmentSequence": [
           1
          ],
          "classOfService": "Q",
          "cabin": "Economy",
          "fareBasisCode": "QWAUURKV",
          "fareType": "AirlinePrivateFare",
          "Brand": {
           "@type": "Brand",
           "BrandRef": "b3"
          }
         }
        ]
       }
      ]
     },
     {
      "@type": "ProductAir",
      "totalDuration": "PT2H24M",
      "id": "p3",
      "FlightSegment": [
       {
        "@type": "FlightSegment",
        "id": "s4",
        "sequence": 1,
        "Flight": {
         "@type": "FlightDetail",
         "duration": "PT2H24M",
         "carrier": "AA",
         "number": "2357",
         "equipment": "321",
         "id": "f4",
         "Identifier": {
          "value": "F4"
         },
         "Departure": {
          "@type": "DepartureDetail",
          "terminal": "0",
          "location": "DFW",
          "date": "2024-07-31",
          "time": "08:25:00"
         },
         "Arrival": {
          "@type": "ArrivalDetail",
          "location": "DEN",
          "date": "2024-07-31",
          "time": "09:49:00"
         }
        }
       }
      ],
      "PassengerFlight": [
       {
        "@type": "PassengerFlight",
        "passengerQuantity": 1,
        "passengerTypeCode": "ADT",
        "FlightProduct": [
         {
          "@type": "FlightProduct",
          "segmentSequence": [
           1
          ],
          "classOfService": "Q",
          "cabin": "Economy",
          "fareBasisCode": "QWAUURKV",
          "fareType": "AirlinePrivateFare",
          "Brand": {
           "@type": "Brand",
           "BrandRef": "b3"
          }
         }
        ]
       }
      ]
     }
    ],
    "Price": {
     "@type": "PriceDetail",
     "CurrencyCode": {
      "decimalPlace": 2,
      "value": "AUD"
     },
     "Base": 556,
     "TotalTaxes": 115.7,
     "TotalFees": 0,
     "TotalPrice": 671.7,
     "PriceBreakdown": [
      {
       "@type": "PriceBreakdownAir",
       "quantity": 1,
       "requestedPassengerType": "ADT",
       "Amount": {
        "@type": "Amount",
        "CurrencyCode": {
         "value": "AUD"
        },
        "Base": 556,
        "Taxes": {
         "@type": "TaxesDetail",
         "TotalTaxes": 115.7,
         "Tax": [
          {
           "taxCode": "US",
           "description": "US Transportation Tax",
           "value": 21.85
          },
          {
           "taxCode": "US",
           "description": "US Transportation Tax",
           "value": 19.85
          },
          {
           "taxCode": "XF",
           "description": "US Passenger Facility Charge",
           "value": 6.8
          },
          {
           "taxCode": "AY",
           "description": "United States Passenger Civil Aviation Security Service Fee",
           "value": 16.8
          },
          {
           "taxCode": "ZP",
           "description": "United States Flight Segment Tax Domestic",
           "value": 7.5
          },
          {
           "taxCode": "XF",
           "description": "US Passenger Facility Charge",
           "value": 6.8
          },
          {
           "taxCode": "ZP",
           "description": "United States Flight Segment Tax Domestic",
           "value": 7.5
          },
          {
           "taxCode": "XF",
           "description": "US Passenger Facility Charge",
           "value": 6.8
          },
          {
           "taxCode": "ZP",
           "description": "United States Flight Segment Tax Domestic",
           "value": 7.5
          },
          {
           "taxCode": "XF",
           "description": "US Passenger Facility Charge",
           "value": 6.8
          },
          {
           "taxCode": "ZP",
           "description": "United States Flight Segment Tax Domestic",
           "value": 7.5
          }
         ]
        },
        "Fees": {
         "@type": "FeesDetail",
         "TotalFees": 0
        },
        "Total": 671.7
       }
      }
     ]
    },
    "TermsAndConditionsFull": [
     {
      "@type": "TermsAndConditionsFullAir",
      "secureFlightPassengerDataRequiredInd": true,
      "ExpiryDate": "2024-06-28T05:20:53Z",
      "ValidatingAirline": [
       {
        "@type": "ValidatingAirline",
        "ValidatingAirline": "AA"
       }
      ],
      "PaymentTimeLimit": "2024-06-28T23:59:00Z"
     }
    ]
   }
     ],
  "Identifier": {
   "value": "2a013bba-74ef-4180-8350-a2dcb44b8da5_PC"
  },
  "ReferenceList": [
   {
    "@type": "ReferenceListBrand",
    "Brand": [
     {
      "@type": "Brand",
      "name": "Basic Economy",
      "id": "b0",
      "BrandAttribute": [
       {
        "@type": "BrandAttribute",
        "classification": "Rebooking",
        "inclusion": "Not Offered",
        "groupCode": "BF"
       },
       {
        "@type": "BrandAttribute",
        "classification": "SeatAssignment",
        "inclusion": "Chargeable",
        "groupCode": "SA"
       },
       {
        "@type": "BrandAttribute",
        "classification": "CheckedBag",
        "inclusion": "Chargeable",
        "groupCode": "BG"
       },
       {
        "@type": "BrandAttribute",
        "classification": "Refund",
        "inclusion": "Not Offered",
        "groupCode": "BF"
       }
      ]
     },
     {
      "@type": "Brand",
      "name": "Main Cabin Flexible",
      "id": "b1",
      "BrandAttribute": [
       {
        "@type": "BrandAttribute",
        "classification": "SeatAssignment",
        "inclusion": "Included",
        "groupCode": "SA"
       },
       {
        "@type": "BrandAttribute",
        "classification": "CheckedBag",
        "inclusion": "Chargeable",
        "groupCode": "BG"
       },
       {
        "@type": "BrandAttribute",
        "classification": "Refund",
        "inclusion": "Included",
        "groupCode": "BF"
       }
      ]
     },
     {
      "@type": "Brand",
      "name": "Main Plus",
      "id": "b2",
      "BrandAttribute": [
       {
        "@type": "BrandAttribute",
        "classification": "SeatAssignment",
        "inclusion": "Included",
        "groupCode": "SA"
       },
       {
        "@type": "BrandAttribute",
        "classification": "CheckedBag",
        "inclusion": "Included",
        "groupCode": "BG"
       },
       {
        "@type": "BrandAttribute",
        "classification": "Refund",
        "inclusion": "Included",
        "groupCode": "BF"
       }
      ]
     },
     {
      "@type": "Brand",
      "name": "Main Select",
      "id": "b3",
      "BrandAttribute": [
       {
        "@type": "BrandAttribute",
        "classification": "SeatAssignment",
        "inclusion": "Included",
        "groupCode": "SA"
       },
       {
        "@type": "BrandAttribute",
        "classification": "CheckedBag",
        "inclusion": "Chargeable",
        "groupCode": "BG"
       },
       {
        "@type": "BrandAttribute",
        "classification": "Refund",
        "inclusion": "Included",
        "groupCode": "BF"
       }
      ],
      "AdditionalBrandAttribute": [
       {
        "@type": "AdditionalBrandAttribute",
        "groupCode": "TS",
        "Classification": "Priority CheckIn",
        "Inclusion": "Included"
       }
      ]
     },
     {
      "@type": "Brand",
      "name": "First",
      "id": "b4",
      "BrandAttribute": [
       {
        "@type": "BrandAttribute",
        "classification": "SeatAssignment",
        "inclusion": "Included",
        "groupCode": "SA"
       },
       {
        "@type": "BrandAttribute",
        "classification": "CheckedBag",
        "inclusion": "Included",
        "groupCode": "BG"
       },
       {
        "@type": "BrandAttribute",
        "classification": "Refund",
        "inclusion": "Included",
        "groupCode": "BF"
       }
      ],
      "AdditionalBrandAttribute": [
       {
        "@type": "AdditionalBrandAttribute",
        "groupCode": "TS",
        "Classification": "Priority CheckIn",
        "Inclusion": "Included"
       }
      ]
     },
     {
      "@type": "Brand",
      "name": "First Flexible",
      "id": "b5",
      "BrandAttribute": [
       {
        "@type": "BrandAttribute",
        "classification": "SeatAssignment",
        "inclusion": "Included",
        "groupCode": "SA"
       },
       {
        "@type": "BrandAttribute",
        "classification": "CheckedBag",
        "inclusion": "Included",
        "groupCode": "BG"
       },
       {
        "@type": "BrandAttribute",
        "classification": "Refund",
        "inclusion": "Included",
        "groupCode": "BF"
       }
      ],
      "AdditionalBrandAttribute": [
       {
        "@type": "AdditionalBrandAttribute",
        "groupCode": "TS",
        "Classification": "Priority CheckIn",
        "Inclusion": "Included"
       }
      ]
     },
     {
      "@type": "Brand",
      "name": "Flagship Business Flexible",
      "id": "b6",
      "BrandAttribute": [
       {
        "@type": "BrandAttribute",
        "classification": "SeatAssignment",
        "inclusion": "Included",
        "groupCode": "SA"
       },
       {
        "@type": "BrandAttribute",
        "classification": "CheckedBag",
        "inclusion": "Included",
        "groupCode": "BG"
       },
       {
        "@type": "BrandAttribute",
        "classification": "Refund",
        "inclusion": "Included",
        "groupCode": "BF"
       }
      ],
      "AdditionalBrandAttribute": [
       {
        "@type": "AdditionalBrandAttribute",
        "groupCode": "TS",
        "Classification": "Priority CheckIn",
        "Inclusion": "Included"
       },
       {
        "@type": "AdditionalBrandAttribute",
        "groupCode": "LG",
        "Classification": "Lounge Access",
        "Inclusion": "Included"
       }
      ]
     }
    ]
   }
  ]
 }
}