# Exchange Price Quote (GDS)

The Product Specific Search function of the Exchange Search API is the second step in the GDS exchange workflow, after Eligibility. It supports searching for a specified itinerary and in addition can provide alternate options. The response details any differences in base fare, taxes, fees, and total price between the currently ticketed itinerary and the possible new itinerary.

Endpoint: POST /pricequote/catalogofferingsairchange/productspecificsearch
Version: 11.33.0
Security: bearerAuth

## Header parameters:

  - `travelportPlusSessionIdentifier` (string)
    travelportPlusSessionIdentifier used to maintain an established agency session
    Example: "49f58f5f-c443-43b4-9f5d-be405fd00a01"

  - `TraceId` (string)
    Identifier used to correlate Air API invocations across a multi-call business flows.
    Example: "TraceID_123456789"

  - `XAUTH_TRAVELPORT_ACCESSGROUP` (string)
    Identifies the Travelport access group with which the caller is associated
    Example: "19Y88702-C27A-4E5D-829A-89D7016688B1"

  - `TVP-PCC-Core` (string)
    Allows user to pass PCC instead of Access Group ID
    Example: "DU7_1G"

  - `Accept-Encoding` (string, required)
    Comma-separated list of acceptable encodings like gzip and/or deflate
    Example: "gzip, deflate"

## Request fields (application/json):

  - `@type` (string, required)
    Example: "CatalogOfferingsQueryProductSpecificSearch"

  - `detailView` (boolean)
    If true, detail view will be returned in response
    Example: true

  - `lowFareFinderInd` (boolean)
    Provides pricing flexibility around class of service. If not sent, the response returns fares only in the requested class of service. If true, returns the lowest fares available in any class of service available, which may not be the same as the requested class. Note that if lowFareFinderInd is sent with true and CabinPreference is sent, the only supported value for CabinPreference/type is Permitted. When lowFareFindInd=true and brand attributes are not disabled (inhibitBrandContentInd), 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. GDS only; not supported for NDC.
    Example: true

  - `returnBrandedfaresInd` (boolean)
    If true, branded fares will be returned in the response
    Example: true

  - `BuildFromProductsRequestAirChange` (object, required)
    full payload used to build an Offer

  - `BuildFromProductsRequestAirChange.@type` (string, required)
    Discriminator. Child classes BuildFromProductsRequestAir (Next leg search and Price APIs), BuildFromProductsRequestAirSearch, and BuildFromProductsRequestAirChange (TripChange API)
    Example: "BuildFromProductsRequestAir"

  - `BuildFromProductsRequestAirChange.PricingModifiersAirChange` (object)
    Pricing Modifiers that can be used to influence the Price of an Exchanged Offer

  - `BuildFromProductsRequestAirChange.PricingModifiersAirChange.@type` (string)
    Example: "PricingModifiersAirChange"

  - `BuildFromProductsRequestAirChange.PricingModifiersAirChange.currencyCode` (string)
    ISO 4217 currency code
    Example: "USD"

  - `BuildFromProductsRequestAirChange.PricingModifiersAirChange.FareSelection` (object)
    May include FareSelectionDetail, RefundOptions, ChangeOptions objects.

  - `BuildFromProductsRequestAirChange.PricingModifiersAirChange.FareSelection.@type` (string, required)
    Discriminator. Child class FareSelectionDetail.
    Example: "FareSelection"

  - `BuildFromProductsRequestAirChange.PricingModifiersAirChange.FareSelection.fareType` (string)
    Defines the type of fares to return (Only public fares, Only private fares, Only agency private fares, Only
    Enum: "PublicFaresOnly", "PrivateFaresOnly", "AgencyPrivateFaresOnly", "AirlinePrivateFaresOnly", "PublicAndPrivateFares", "NetFaresOnly", "AllFares"

  - `BuildFromProductsRequestAirChange.PricingModifiersAirChange.FareSelection.RefundOptions` (object)
    Supports requesting only fares that meet certain refund criteria. GDS only; not supported for NDC. Search supports sending up to 12 refundability options. The following combinations are mutually exclusive; if sent, Search ignores them and returns a warning message: NonRefundable cannot also be sent with PartialRefund. Refundable cannot also be sent with ChangeOptions/changeTypes=PenaltyToChange

  - `BuildFromProductsRequestAirChange.PricingModifiersAirChange.FareSelection.RefundOptions.@type` (string, required)
    Discriminator. No child classes.
    Example: "RefundOptions"

  - `BuildFromProductsRequestAirChange.PricingModifiersAirChange.FareSelection.RefundOptions.refundTypes` (array, required)
    Enum: "Refundable", "NonRefundable", "PartialRefund"

  - `BuildFromProductsRequestAirChange.PricingModifiersAirChange.FareSelection.RefundOptions.RefundPenaltyRange` (object)
    Not currently supported. User can express a minimum and maximum Refund penalty range that will be included in the result set.

  - `BuildFromProductsRequestAirChange.PricingModifiersAirChange.FareSelection.RefundOptions.RefundPenaltyRange.@type` (string)
    Example: "RefundPenaltyRange"

  - `BuildFromProductsRequestAirChange.PricingModifiersAirChange.FareSelection.RefundOptions.RefundPenaltyRange.Minimum` (object)
    Parent object when amount is applied as an Amount or a Percent.

  - `BuildFromProductsRequestAirChange.PricingModifiersAirChange.FareSelection.RefundOptions.RefundPenaltyRange.Minimum.@type` (string, required)
    Discriminator classes AmountPercentAmount or AmountPercentPercent
    Example: "AmountPercentAmount"

  - `BuildFromProductsRequestAirChange.PricingModifiersAirChange.FareSelection.RefundOptions.RefundPenaltyRange.Minimum.application` (string)
    Type of commission
    Enum: "Full", "Partial", "Non-paying", "No-show", "Adjustment", "Commissionable"

  - `BuildFromProductsRequestAirChange.PricingModifiersAirChange.FareSelection.RefundOptions.RefundPenaltyRange.Maximum` (object)
    Parent object when amount is applied as an Amount or a Percent.

  - `BuildFromProductsRequestAirChange.PricingModifiersAirChange.FareSelection.ChangeOptions` (object)
    Supports requesting only fares that meet certain change criteria. GDS only; not supported for NDC. Search supports sending up to 12 changeability options. ChangeOptions.changeTypes=PenaltyToChange cannot be sent with RefundOptions.Refundable. If sent, Search ignores them and returns a warning message

  - `BuildFromProductsRequestAirChange.PricingModifiersAirChange.FareSelection.ChangeOptions.@type` (string)
    Discriminator. No child classes.
    Example: "ChangeOptions"

  - `BuildFromProductsRequestAirChange.PricingModifiersAirChange.FareSelection.ChangeOptions.changeTypes` (array, required)
    Enum: "Changeable", "NonChangeable", "PenaltyToChange"

  - `BuildFromProductsRequestAirChange.PricingModifiersAirChange.FareSelection.ChangeOptions.ChangePenaltyRange` (object)
    Not currently supported. User can express a minimum and maximum Change penalty range that will be included in the result set

  - `BuildFromProductsRequestAirChange.PricingModifiersAirChange.FareSelection.ChangeOptions.ChangePenaltyRange.@type` (string)
    Example: "ChangePenaltyRange"

  - `BuildFromProductsRequestAirChange.PricingModifiersAirChange.FareSelection.ChangeOptions.ChangePenaltyRange.Minimum` (object)
    Parent object when amount is applied as an Amount or a Percent.

  - `BuildFromProductsRequestAirChange.PricingModifiersAirChange.FareSelection.ChangeOptions.ChangePenaltyRange.Maximum` (object)
    Parent object when amount is applied as an Amount or a Percent.

  - `BuildFromProductsRequestAirChange.PricingModifiersAirChange.FareSelection.FareQualiferString` (array)
    Request specific private leisure fares. Supported values vary by NDC carrier. For detailed NDC support by carrier, see the Knowledge Base article NDC capabilities by airline through JSON API in the guide section. This value is returned in FlightProduct.FareQualifierString if supplied by the airline. (Note the misspelling in request parameter)
    Example: ["Tour"]

  - `BuildFromProductsRequestAirChange.PricingModifiersAirChange.FareSelection.FareQualifier` (array)

  - `BuildFromProductsRequestAirChange.PricingModifiersAirChange.FareSelection.FareQualifier.value` (string)
    Deprecated - do not use. Replaced by FareQualiferString
    Enum: "Consolidator", "Government", "Marine", "Military", "Reward", "StandBy", "Staff", "Student", "Tour", "Youth", "VistFriendsAndRelatives"

  - `BuildFromProductsRequestAirChange.PricingModifiersAirChange.OrganizationInformation` (object)
    In search API sends account code/s to request negotiated fares. For NDC supports corporate loyalty program and GST Information. This information is returned in TermsAndConditions.OrganizationInformation.

  - `BuildFromProductsRequestAirChange.PricingModifiersAirChange.OrganizationInformation.@type` (string, required)
    Discriminator. No child classes
    Example: "OrganizationInformation"

  - `BuildFromProductsRequestAirChange.PricingModifiersAirChange.OrganizationInformation.OrganizationIdentifier` (array)

  - `BuildFromProductsRequestAirChange.PricingModifiersAirChange.OrganizationInformation.OrganizationIdentifier.value` (string)
    The value of the code type.
    Example: "JBD123456"

  - `BuildFromProductsRequestAirChange.PricingModifiersAirChange.OrganizationInformation.OrganizationIdentifier.supplier` (string)
    The IATA code for the airline on which the code type is applicable.
    Example: "AA"

  - `BuildFromProductsRequestAirChange.PricingModifiersAirChange.OrganizationInformation.OrganizationIdentifier.organizationCodeType` (string)
    Sends a description for the OrganizationIdentifer value
    Enum: "Account", "OrganizationLoyaltyProgram", "Tour", "TicketDesignator"

  - `BuildFromProductsRequestAirChange.PricingModifiersAirChange.OrganizationInformation.OrganizationIdentifier.segmentSequenceList` (array)
    Returned in response when the code is applicable to a specified segment sequence
    Example: [1,2,3]

  - `BuildFromProductsRequestAirChange.PricingModifiersAirChange.OrganizationInformation.OrganizationIdentifier.productRef` (array)
    Returned in response when the code is applicable to a specified product
    Example: ["product_1"]

  - `BuildFromProductsRequestAirChange.PricingModifiersAirChange.OrganizationInformation.OrganizationIdentifier.accountCodeFaresOnlyInd` (boolean)
    Indicator to limit the fares returned to only fares filed for the specified account code. If true, returns only fares filed for the account code/s in OrganizationIdentifier/value. If sending multiple account codes, send with each instance of OrganizationIdentifier. If false or omitted, returns account fares and other fares. Default is false. If an account code is sent without accountCodeFaresOnlyInd=true, the response includes any fares filed for that account code plus fares that are not specific to the account code. If accountCodeFaresOnlyInd=true and no account code is sent, the indicator is ignored and the response returns all fares and a warning message that the request must include an account code. GDS only; not supported for NDC.
    Example: true

  - `BuildFromProductsRequestAirChange.PricingModifiersAirChange.OrganizationInformation.GSTRegistrationNumber` (array)
    NDC only. Supported during book 'Add Offer' workflow.

  - `BuildFromProductsRequestAirChange.PricingModifiersAirChange.OrganizationInformation.GSTRegistrationNumber.value` (string, required)
    The GST registered number for the business.
    Example: "07AAGFF2194N1Z1"

  - `BuildFromProductsRequestAirChange.PricingModifiersAirChange.OrganizationInformation.GSTRegistrationNumber.telephone` (string, required)
    Business telephone number
    Example: "222-222-222"

  - `BuildFromProductsRequestAirChange.PricingModifiersAirChange.OrganizationInformation.GSTRegistrationNumber.address` (string, required)
    Business address
    Example: "1122 sample trail, CO, USA, 21232"

  - `BuildFromProductsRequestAirChange.PricingModifiersAirChange.OrganizationInformation.GSTRegistrationNumber.country` (string, required)
    IATA country code of the business.
    Example: "IND"

  - `BuildFromProductsRequestAirChange.PricingModifiersAirChange.OrganizationInformation.GSTRegistrationNumber.companyName` (string, required)
    Business name
    Example: "Adecco"

  - `BuildFromProductsRequestAirChange.PricingModifiersAirChange.OrganizationInformation.GSTRegistrationNumber.email` (string, required)
    Business E-Mail
    Example: "sample@adecco.com"

  - `BuildFromProductsRequestAirChange.PricingModifiersAirChange.WaiverCode` (object)
    A code assigned by an airline to support waiver of fees or ticket value as a result of disruption to the passenger.

  - `BuildFromProductsRequestAirChange.PricingModifiersAirChange.WaiverCode.value` (string)

  - `BuildFromProductsRequestAirChange.PricingModifiersAirChange.WaiverCode.reasonCode` (integer)
    A code assigned to identify the reason for disruption
    Example: 2

  - `BuildFromProductsRequestAirChange.PricingModifiersAirChange.WaiverCode.waiverType` (string)
    List of waiver types.
    Enum: "ChangePenalty", "PriceDifference", "ChangePenaltyAndPriceDifference", "RefundPenalty", "NameChangePenalty"

  - `BuildFromProductsRequestAirChange.PricingModifiersAirChange.TaxExemption` (object)
    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 OR countries and taxCodes per below. TaxExemption supports up to nine values for countries, for taxCodes, or for countries and taxCodes combined. The response returns any exempt taxes with exemptInd=true and a zero value.

  - `BuildFromProductsRequestAirChange.PricingModifiersAirChange.TaxExemption.@type` (string)
    Discriminator. No child classes.
    Example: "TaxExemption"

  - `BuildFromProductsRequestAirChange.PricingModifiersAirChange.TaxExemption.countries` (array)
    ISO country code. One or more two-letter alphanumeric codes for the countries in which the taxCodes sent are tax exempt.
    Example: ["GB","MX"]

  - `BuildFromProductsRequestAirChange.PricingModifiersAirChange.TaxExemption.taxCodes` (array)
    One or more two-letter alphanumeric tax codes to mark as exempt.
    Example: ["US"]

  - `BuildFromProductsRequestAirChange.PricingModifiersAirChange.TaxExemption.allTaxesExemptInd` (boolean)
    Marks all taxes as exempt. If true, marks all taxes in the response as exempt. Do not send if false; instead, use countries and taxCodes to specify which taxes to exempt.
    Example: true

  - `BuildFromProductsRequestAirChange.PricingModifiersAirChange.PromotionalCode` (object)
    NDC only. Not supported for GDS. Any NDC airline designated promotional code.

  - `BuildFromProductsRequestAirChange.PricingModifiersAirChange.PromotionalCode.value` (string)
    The promotional code to apply
    Example: "CDFRT"

  - `BuildFromProductsRequestAirChange.PricingModifiersAirChange.PromotionalCode.supplierCode` (string, required)
    The IATA code for the airline on which the promotional code is applicable.
    Example: "AA"

  - `BuildFromProductsRequestAirChange.PricingModifiersAirChange.SellCity` (string)
    Overrides the sell city of the requestor
    Example: "MEX"

  - `BuildFromProductsRequestAirChange.PricingModifiersAirChange.TicketCity` (string)
    Overrides the ticket city of the requestor
    Example: "MEX"

  - `BuildFromProductsRequestAirChange.PricingModifiersAirChange.PricingPCC` (string)
    Overrides the pricing PCC of the requestor
    Example: "0XS4"

  - `BuildFromProductsRequestAirChange.PricingModifiersAirChange.TicketingPCC` (string)
    Overrides the ticketing PCC of the requestor
    Example: "0XCD"

  - `BuildFromProductsRequestAirChange.PricingModifiersAirChange.CalculatedFareAdjustment` (object)
    Used in Exchange Search to modify the Price of the Fare. Discriminator classes CalculatedFareAdjustmentDiscount or CalculatedFareAdjustmentIncrease

  - `BuildFromProductsRequestAirChange.PricingModifiersAirChange.CalculatedFareAdjustment.@type` (string, required)
    Example: "CalculatedFareAdjustmentDiscount"

  - `BuildFromProductsRequestAirChange.PricingModifiersAirChange.BrandPreference` (array)

  - `BuildFromProductsRequestAirChange.PricingModifiersAirChange.BrandPreference.@type` (string, required)
    Discriminator. No child classes exist
    Example: "BrandPreference"

  - `BuildFromProductsRequestAirChange.PricingModifiersAirChange.BrandPreference.brandTier` (integer)
    The brand tier you want to override
    Example: 1

  - `BuildFromProductsRequestAirChange.PricingModifiersAirChange.BrandPreference.legSequence` (array)
    Correlates with legSequence in SearchCriteriaFlight
    Example: [1,2]

  - `BuildFromProductsRequestAirChange.PricingModifiersAirChange.keepToBrandInd` (boolean)
    If true, the offerings returned will be of the same brand as the original Offer
    Example: true

  - `BuildFromProductsRequestAirChange.PricingModifiersAirChange.returnMostRestrictiveBrandInd` (boolean)
    if true, the most restrictive brand will be returned in the response when there are different brands present in the Offering
    Example: true

  - `BuildFromProductsRequestAirChange.PricingModifiersAirChange.doNotNetInd` (boolean)
    If true, this exchange will not net any residual/refundable amounts against due amounts.

  - `BuildFromProductsRequestAirChange.ProductCriteriaAir` (array, required)

  - `BuildFromProductsRequestAirChange.ProductCriteriaAir.@type` (string)
    Discriminator. No child classes.
    Example: "ProductCriteriaAir"

  - `BuildFromProductsRequestAirChange.ProductCriteriaAir.sequence` (integer, required)
    Optional sequence of this block of product criteria
    Example: 1

  - `BuildFromProductsRequestAirChange.ProductCriteriaAir.SponsoredFlightAttributes` (object)
    Coming soon.

  - `BuildFromProductsRequestAirChange.ProductCriteriaAir.SponsoredFlightAttributes.@type` (string, required)
    Discriminator. No child classes.
    Example: "SponsoredFlightAttributes"

  - `BuildFromProductsRequestAirChange.ProductCriteriaAir.SponsoredFlightAttributes.positionNumber` (integer)
    The display position number of the sponsored option

  - `BuildFromProductsRequestAirChange.ProductCriteriaAir.SponsoredFlightAttributes.adID` (string)
    The advertisement ID

  - `BuildFromProductsRequestAirChange.ProductCriteriaAir.SponsoredFlightAttributes.trackingID` (string)
    Unique tracking ID for sponsored flights campaign required in end to end workflow.

  - `BuildFromProductsRequestAirChange.ProductCriteriaAir.SponsoredFlightAttributes.sponsoredFlightInd` (boolean)
    If true, this option is a sponsored flight option.

  - `BuildFromProductsRequestAirChange.ProductCriteriaAir.SpecificFlightCriteria` (array, required)

  - `BuildFromProductsRequestAirChange.ProductCriteriaAir.SpecificFlightCriteria.@type` (string)
    Discriminator. No child classes.
    Example: "SpecificFlightCriteria"

  - `BuildFromProductsRequestAirChange.ProductCriteriaAir.SpecificFlightCriteria.carrier` (string, required)
    IATA code for the airline carrier for this flight.
    Example: "BA"

  - `BuildFromProductsRequestAirChange.ProductCriteriaAir.SpecificFlightCriteria.flightNumber` (string, required)
    The flight Number.
    Example: "980"

  - `BuildFromProductsRequestAirChange.ProductCriteriaAir.SpecificFlightCriteria.departureDate` (string, required)
    Local date of departure.
    Example: "2025-10-25"

  - `BuildFromProductsRequestAirChange.ProductCriteriaAir.SpecificFlightCriteria.departureTime` (string)
    Local time of departure time.
    Example: "68400"

  - `BuildFromProductsRequestAirChange.ProductCriteriaAir.SpecificFlightCriteria.arrivalDate` (string)
    Local arrival date.
    Example: "2025-10-25"

  - `BuildFromProductsRequestAirChange.ProductCriteriaAir.SpecificFlightCriteria.arrivalTime` (string)
    Local time of arrival.
    Example: "80100"

  - `BuildFromProductsRequestAirChange.ProductCriteriaAir.SpecificFlightCriteria.from` (string, required)
    The origin IATA airport code from which the flight departs.
    Example: "LHR"

  - `BuildFromProductsRequestAirChange.ProductCriteriaAir.SpecificFlightCriteria.to` (string, required)
    The destination IATA airport code where the flight arrives.
    Example: "PAR"

  - `BuildFromProductsRequestAirChange.ProductCriteriaAir.SpecificFlightCriteria.cabin` (string)
    Specifies the cabin type (e.g. first, business, economy). If sent for Flight Specific Search, this field is ignored.
    Enum: "PremiumFirst", "First", "Business", "PremiumEconomy", "Economy"

  - `BuildFromProductsRequestAirChange.ProductCriteriaAir.SpecificFlightCriteria.classOfService` (string)
    The class of service. If sent for Flight Specific Search, this field is ignored.
    Example: "F"

  - `BuildFromProductsRequestAirChange.ProductCriteriaAir.SpecificFlightCriteria.brandTier` (integer)
    Brand tier.
    Example: 2

  - `BuildFromProductsRequestAirChange.ProductCriteriaAir.SpecificFlightCriteria.segmentSequence` (integer, required)
    Segment sequence is used to identify the order of the flight segments.

  - `BuildFromProductsRequestAirChange.ProductCriteriaAir.SpecificFlightCriteria.additionalCabins` (array)
    Request additional SeatMap cabins (not supported in full payload Price or Book requests)
    Enum: "PremiumFirst", "First", "Business", "PremiumEconomy", "Economy"

  - `BuildFromProductsRequestAirChange.ProductCriteriaAir.SpecificFlightCriteria.passiveSegmentStatus` (string)
    Applicable to Book workflow only. If the segment is to be sold as passive enter the passive segment status. AK supplier message sent upon cancel only, BK supplier message sent on book and cancel, YK Information only, no supplier message sent, segment cannot be priced or ticketed.
    Example: "AK"

  - `BuildFromProductsRequestAirChange.ProductCriteriaAir.SpecificFlightCriteria.id` (string)
    Unique id to support referencing of this specific passenger criteria in the book offer construction workflow.

  - `BuildFromProductsRequestAirChange.ProductCriteriaAir.SpecificFlightCriteria.AvailabilitySourceCode` (string)
    Returned to assist in troubleshooting. Returned in the Search, Air Availability, Exchange Search, AirPrice, and Workbench Commit responses. Recommended to send in the AirPrice Full Payload and Add Offer Full Payload requests. Not returned for Ancillary Shop or Fare Rules. GDS only; not supported for NDC.
    Enum: "A", "B", "C", "D", "E", "F", "G", "H", "I", "J", "K", "L", "M", "N", "O", "P", "Q", "S", "T", "U", "X", "Y", "Z"

  - `BuildFromProductsRequestAirChange.ProductCriteriaAir.SpecificFlightCriteria.ContentSource` (string)
    Indicates the owner the offer or document.
    Enum: "GDS", "NDC", "LCC", "API"

  - `BuildFromProductsRequestAirChange.ProductCriteriaAir.SpecificFlightCriteria.boundFlightsInd` (boolean)
    If true indicates that the flight availability was polled (availability check) using connecting segments. If false, flights were polled as point to point segments. In full payload AirPrice, when used in conjunction with reCheckInventoryInd set as true on the leading segment/s on a leg with connecting flight/s to also check availability on the connecting flight/s by booking and releasing seats in the requested class of service on those flight/s. For example, if a leg has two connections, send boundFlightsInd for the first two of the three flights. Must also send reCheckInventoryInd=true per above. If any or all segments are not bookable, AirPrice returns a message that the air segment/s are not bookable and the dates and city pairs of the segments that are not bookable.
    Example: true

  - `BuildFromProductsRequestAirChange.ProductCriteriaAir.SpecificFlightCriteria.fareBasisCodeOverride` (string)
    Use PricingModifiersAir for fare basis code override.
    Example: "YEE1Y"

  - `BuildFromProductsRequestAirChange.ProductCriteriaAir.SupplierLocator` (object)
    Required for passive segment bookings when GDS ticketing is required (AK segment status). Not supported for Search or Price APIs.

  - `BuildFromProductsRequestAirChange.ProductCriteriaAir.SupplierLocator.value` (string)
    Example: "WTR45G"

  - `BuildFromProductsRequestAirChange.ProductCriteriaAir.SupplierLocator.supplierCode` (string)
    Supplier Code
    Example: "AA"

  - `BuildFromProductsRequestAirChange.ProductCriteriaAir.SupplierLocator.supplierName` (string)
    Name of the supplier
    Example: "American Airlines"

  - `PassengerCriteria` (array, required)

  - `PassengerCriteria.@type` (string, required)
    Discriminator. No child classes.
    Example: "PassengerCriteria"

  - `PassengerCriteria.number` (integer, required)
    The amount of passengers associated with this passenger type code
    Example: 1

  - `PassengerCriteria.age` (integer)
    The age of the passenger. Travelport recommends sending age only with PTCs that require age for pricing. For child passengers, Travelport recommends sending the age of the child in the age attribute plus the PTC CNN. Travelport recommends against sending CNN without age, or the CHD PTC. Many fares cannot be quoted for 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. During booking, date of birth is required for all child and infant PTCs (Add Traveler payload in Traveler/birthDate).
    Example: 26

  - `PassengerCriteria.passengerTypeCode` (string)
    Required field for Air Search and Flight specific search. 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 API guides to download a full list of PTCs. NDC carriers BA, SQ, AV, AA, and AF/KLM offer teen/young adult tax exemptions from the UK Air Passenger Duty (GB tax). Send PTC with the value YTH and send the passengers age per below. The PTC may be returned as ADT, or Cxx in which xx is the age, but the tax exemption is applied in the pricing on these NDC carriers. When running a multiple passenger search for NDC on Qantas, Qantas supports only these PTCs: ADT, CHD, CNN, INF. Sending any other PTC may result in an error at ticketing.
    Example: "ADT"

  - `PassengerCriteria.birthDate` (string)
    The date of birth of the passenger. May be used in age validation for fares with age restrictions.
    Example: "2020-01-16"

  - `PassengerCriteria.CustomerLoyalty` (array)
    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 Air Price request and the Add Traveler request. 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 a warning message that the FQTV is invalid, and the invalid number is cached to prevent a potential booking failure. In Search API CustomerLoyalty is only sent to NDC carriers. Ignored for GDS Search.

  - `PassengerCriteria.CustomerLoyalty.value` (string, required)
    Number on loyalty card.
    Example: "132456"

  - `PassengerCriteria.CustomerLoyalty.id` (string)
    Optional Customer Loyalty Id. Not saved
    Example: "Loyalty_1"

  - `PassengerCriteria.CustomerLoyalty.priority` (integer)
    Optional Numeric Priority Code
    Example: 2

  - `PassengerCriteria.CustomerLoyalty.programId` (string)
    "Specifies an identifier to indicate the company owner of the loyalty program. Typically two characters.
For frequent guest number, the hotel supplier or brand code. 
For frequent flyer number, the air supplier code of the loyalty program."
    Example: "United"

  - `PassengerCriteria.CustomerLoyalty.programName` (string)
    Supplier's loyalty program name.
    Example: "Frontier-EarlyReturns"

  - `PassengerCriteria.CustomerLoyalty.supplierType` (string)
    The type of supplier of a loyalty program. Uses 'hotel' for frequent guest number or 'air' for frequent flyer number.
    Example: "Airline"

  - `PassengerCriteria.CustomerLoyalty.supplier` (string, required)
    Supplier of a loyalty program (typically 2 characters representing the hotel, brand, or airline).
    Example: "UA"

  - `PassengerCriteria.CustomerLoyalty.tier` (string)
    Customer Loyalty tier
    Example: "Silver"

  - `PassengerCriteria.CustomerLoyalty.shareWithSupplier` (array)
    The list of suppliers that the CustomerLoyalty number is shared. Used for cross accrual.
    Example: ["LH"]

  - `PassengerCriteria.CustomerLoyalty.cardHolderName` (string)
    Customer loyalty member name; up to 128 characters are supported. In Air Search, for discounted offers to be returned, the name must be sent as LAST FIRST; e.g.,if SMITH is the last name and JORDAN the first name, send as SMITH JORDAN
    Example: "John Smith"

  - `PassengerCriteria.CustomerLoyalty.validatedInd` (boolean)
    Customer loyalty number has been validated by the supplier
    Example: true

  - `PassengerCriteria.CustomerLoyalty.prefix` (string)
    The cardholder name prefix title like Mr, Mrs, Dr
    Example: "Dr"

  - `PassengerCriteria.CustomerLoyalty.given` (string)
    The First Name of the Cardholder
    Example: "John"

  - `PassengerCriteria.CustomerLoyalty.middle` (string)
    Middle Name of the Cardholder
    Example: "Wilkinson"

  - `PassengerCriteria.CustomerLoyalty.surname` (string)
    Last Name of the Cardholder
    Example: "Smith"

  - `PassengerCriteria.TravelerGeographicLocation` (object)
    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. Any discount applied through TravelerGeographicLocation applies to all travelers, not only to the traveler in this instance of PassengerCriteria. If the discount must apply only to an individual traveler, that traveler requires a separate search and book workflow.

  - `PassengerCriteria.TravelerGeographicLocation.value` (string)
    IATA code for the city, country, or state/province relevant to the local citizen//local resident fare.
    Example: "PMI"

  - `PassengerCriteria.TravelerGeographicLocation.travelerGeographicLocationType` (string)
    The geographic type of the location value
    Enum: "Country", "StateProvince", "City"

  - `PassengerCriteria.TravelerGeographicLocation.residentGeographicCode` (string)
    Resident code for Spanish residency fares for NDC. Any discount will apply to all travelers, not only to the traveler in this instance of PassengerCriteria. Supported/validated only for NDC to support local citizen fares.

  - `PassengerCriteria.TravelerGeographicLocation.generalLargeFamilyResidentDiscountInd` (boolean)
    Send only if true and request qualifies for general large family resident discount, defined as general large families (up to three children) from Spain, from the EU/EEA, or of any other nationality whose residency in Spain is recognized and who are in possession of a large-family certificate issued by the autonomous community in which they live. Supported/validated only for NDC to support local citizen fares.
    Example: true

  - `PassengerCriteria.TravelerGeographicLocation.specialLargeFamilyResidentDiscountInd` (boolean)
    Send only if true and request qualifies for special large family resident discount, defined as special large families (four or more children) from Spain, from the EU/EEA, or of any other nationality whose residency in Spain is recognized and who are in possession of a large-family certificate issued by the autonomous community in which they live. Supported/validated only for NDC to support local citizen fares.
    Example: true

  - `PassengerCriteria.specifiedPassengerTypeCodeOnlyInd` (boolean)
    If true, returns only offers for the specified PTC. If no offers for that PTC are available, an error message that offers were found is returned. GDS only; not supported for NDC. Default is false.
    Example: true

  - `PaymentCriteria` (object, required)
    Used to provide optional payment-card criteria in an Air Search request by sending the IssuerIdentifierNumber/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) fees, including credit card fees. Returned in an instance of Price/PriceBreakdown/Fees/Fee with a feeCode of OB.

  - `PaymentCriteria.@type` (string, required)
    discriminator
    Example: "PaymentCriteria"

  - `PaymentCriteria.IssuerIdentificationNumber` (string)
    6 to 11 digit number. The BIN/IIN of the credit card to be used for payment
    Example: "123456"

  - `PaymentCriteria.PaymentCardCode` (string)
    A two character code for a credit card
    Example: "VI"

  - `PaymentCriteria.DocumentNumber` (array)

  - `PaymentCriteria.DocumentNumber.value` (string)
    Example: "1259900123456"

  - `PaymentCriteria.DocumentNumber.documentIssuer` (string)
    Document issuer
    Example: "BA"

  - `PaymentCriteria.DocumentNumber.documentType` (string)
    Document type like EMD, MCO
    Enum: "EMD", "MCO", "Ticket", "TASF", "Invoice"

  - `PaymentCriteria.DocumentNumber.travelerIdentifierRef` (string)
    traveler identifier reference

  - `PaymentCriteria.DocumentNumber.name` (string)
    The name of the Traveler being referenced.

  - `PaymentCriteria.DocumentNumber.passengerTypeCode` (string)
    The passenger type code of the Traveler being referenced.
    Example: "ADT"

  - `PaymentCriteria.DocumentNumber.id` (string)
    A locally referenced ID

  - `PaymentCriteria.DocumentNumber.description` (string)
    Descriptive text used to identify the contents of a target object

  - `PaymentCriteria.DocumentNumber.uris` (array)
    The URI used to GET the target object in another domain.

  - `PaymentCriteria.FlightPass` (array)
    In Search API, for NDC flight pass bookings this is a required field and must reference the owner in PassengerCriteria. Only one permitted per Search request.

  - `PaymentCriteria.FlightPass.@type` (string, required)
    Discriminator. No child classes
    Example: "FlightPass"

  - `PaymentCriteria.FlightPass.accountNumber` (string, required)
    The flight pass account number
    Example: 140851633093

  - `PaymentCriteria.FlightPass.supplier` (string, required)
    The flight pass supplier code
    Example: "AC"

  - `PaymentCriteria.FlightPass.Description` (array)
    Example: ["FlightPass"]

  - `PaymentCriteria.FlightPass.TravelerIdentifierRef` (array)
    In Search, use the passengerCriteriaRef to reference the owner of the flightpass. This is a mandatory field for Search API.

  - `PaymentCriteria.FlightPass.TravelerIdentifierRef.name` (string)
    Traveler identifier

  - `PaymentCriteria.FlightPass.TravelerIdentifierRef.passengerTypeCode` (string)
    Passenger Type code
    Example: "ADT"

  - `PaymentCriteria.FlightPass.TravelerIdentifierRef.ages` (array)
    The ages of the travelers associated to a particular ptc. For NDC, this value will be returned in PriceBreakdownAir if sent as part of the PassengerCriteria in the Air Search request.
    Example: [15]

  - `PaymentCriteria.FlightPass.TravelerIdentifierRef.passengerCriteriaRef` (string)
    Allows the user to associate passenger criteria information.
    Example: "passengerCriteria_1"

  - `PaymentCriteria.FlightPass.TravelerIdentifierRef.value` (string)

  - `PaymentCriteria.FlightPass.TravelerIdentifierRef.id` (string)
    A locally referenced ID

  - `PaymentCriteria.FlightPass.TravelerIdentifierRef.description` (string)
    Descriptive text used to identify the contents of a target object

  - `PaymentCriteria.FlightPass.TravelerIdentifierRef.uris` (array)
    Uniform Resource Identifier
    Example: ["google.com"]

  - `PaymentCriteria.FlightPass.TravelerIdentifierRef.age` (integer)
    Replaced with ages array. The age of the traveler.
    Example: 11

  - `PaymentCriteria.agencyAccountInd` (boolean)
    If true, payment will be made by agency account
    Example: true

  - `PaymentCriteria.bspInd` (boolean)
    If true, payment will be made by BSP
    Example: true

  - `PaymentCriteria.cashInd` (boolean)
    If true, payment will be made by cash
    Example: true

  - `PaymentCriteria.invoiceInd` (boolean)
    If true, payment will be made by invoice
    Example: true

  - `CustomResponseModifiersAir` (object)
    Modifiers to customize the result set. Includes SearchRepresentation and optional indicators for returning or excluding selected response content. Values sent here can carry forward into the Next Leg Search request and are not re-sent.

  - `CustomResponseModifiersAir.@type` (string, required)
    discriminator
    Example: "CustomResponseModifiersAir"

  - `CustomResponseModifiersAir.BrandAttributeInclusion` (array)
    Supported in Search and Price.

  - `CustomResponseModifiersAir.BrandAttributeInclusion.@type` (string)
    Example: "BrandAttributeInclusion"

  - `CustomResponseModifiersAir.BrandAttributeInclusion.Classification` (array)
    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
    Enum: "CheckedBag", "CarryOn", "PersonalItem", "Rebooking", "Refund", "SeatAssignment", "PremiumSeat", "LieFlatSeat", "Meals", "WiFi", "Other"

  - `CustomResponseModifiersAir.BrandAttributeInclusion.AdditionalClassification` (array)
    Send one or more of the following values to return information about only the specified additional attributes. Supported values ChauffeurTransfer, ExtraLegroom, InFlightEntertainment, LoungeAccess, PriorityBaggage, PriorityBoarding, PriorityCheckIn, PrioritySecurity, PriorityServices, MileageAccrual, Upgrades, USB.

  - `CustomResponseModifiersAir.BrandAttributeInclusion.legSequence` (array)
    Leg sequence not supported for BrandAttributeInclusion.
    Example: [1,2]

  - `CustomResponseModifiersAir.SearchRepresentation` (string)
    Specifies either a journey or leg-based response. Journey returns offers for all legs of the itinerary. Journey is the default. Leg returns offers for only the first leg of the itinerary. Must be followed with a Next Leg Search to select an offer for the first leg and return offers on the subsequent leg to combine with it.Customize search result set as leg or journey based. Next Leg Search requests, and Flight Specific Search requests for less than the full itinerary, are supported only after a leg-based Search, not a journey-based Search. If these requests follow a journey-based Search request, an error message is returned.
    Enum: "Leg", "Journey", "LegWithJourneyData"

  - `CustomResponseModifiersAir.excludePenaltiesInd` (boolean)
    Indicator to omit change and cancel penalties. If true, omits all penalty information from the response. If false or omitted returns any change and penalty details provided by carrier for each offer in TermsAndConditionsFullAir/Penalties. Default is false. GDS only; not supported for NDC. excludePenaltiesInd can also be sent in the AirPrice request. If sent in Search but not in AirPrice, the value sent in Search is cached and applied to the AirPrice results. However, you can override the value sent in Search by sending excludePenaltiesInd in the AirPrice request with the opposite value. For example, if the Search request sends excludePenaltiesInd=true and the AirPrice request sends excludePenaltiesInd=false, the Search response does not return penalties and the AirPrice response does return penalties.If true, Penalties will be excluded from the response.
    Example: true

  - `CustomResponseModifiersAir.excludeBaggageFeesInd` (boolean)
    Indicator to exclude baggage details. If true, excludes baggage fees, carry on fees, and embargo information from the response. Baggage quantity or weight is returned instead. If false or omitted, baggage details returned in response. Default is false. GDS only; not supported for NDC.
    Example: true

  - `CustomResponseModifiersAir.includeFareCalculationInd` (boolean)
    Indicator to request the return of the fare calculation ladder. If true, returns the fare calculation ladder in BestCombinablePrice.PriceBreakdownAir.FareCalculation. If false or omitted, fare calculation ladder is not returned. Default is false. GDS only; not supported for NDC or in the Flight Specific Search full payload request.
    Example: true

  - `CustomResponseModifiersAir.excludeSurchargesInd` (boolean)
    Indicator to exclude a surcharge breakdown. If true, excludes a surcharge breakdown from the response. Baggage quantity or kilos is returned instead. If false or omitted, surcharge breakdown returned in response. Default is false. GDS only; not supported for NDC.
    Example: true

  - `CustomResponseModifiersAir.excludeUnbundledFaresInd` (boolean)
    Supported in Search and Price. Sets whether to return unbundled fares. If true, does not return unbundled fares. If false or omitted, returns unbundled and bundled fares as available. Default is false. GDS only, not supported for NDC.If true, unbundled fares will not be returned in the response
    Example: true

  - `CustomResponseModifiersAir.includeCO2EmissionsDataInd` (boolean)
    Indicator to return CO2 emission data in the Search and Next Leg Search responses. If true, returns CO2 emission data. If false or omitted CO2 emission data not returned. Default is false.
    Example: true

  - `CustomResponseModifiersAir.includeFlightAmenitiesInd` (boolean)
    Indicator to return flight amenities from ATPCO RouteHappy data. If true, includes amenities in the response if available. If false or omitted, amenities are not returned in response. Default is false.
    Example: true

  - `CustomResponseModifiersAir.includeUniversalProductAttributesInd` (boolean)
    Indicator to return universal product attributes (UPAs), which include images, icons, and URLs as provided by ATPCO. Must also send includeFlightAmenitiesInd=true. If true, returns universal product attributes if available. If false or omitted, Universal product attributes not returned. Default is false. UPAs are not returned for direct flights with intermediate stops, non-flight segments such as trains, or for Premium Business class.
    Example: true

  - `CustomResponseModifiersAir.includeBundledAncillariesInd` (boolean)
    NDC only. If true, the search and price response will include bundled air and ancillary offerings/offers. Search and Price response will contain both ProductAir and ProductAncillary plus a new child class of PriceBreakdown: PriceBreakdownAncillaryAir to define the ancillary inclusion and pricing.
    Example: true

  - `CustomResponseModifiersAir.includeFullPenaltyDisclosureInd` (boolean)
    If true, penalty information sourced from ATPCO Cat 31 and 33 will be disclosed. Penalties may be exposed at fare component level and include time windows.

  - `CabinPreference` (array)

  - `CabinPreference.@type` (string, required)
    Discriminator. No child classes exist
    Example: "CabinPreference"

  - `CabinPreference.preferenceType` (string)
    Sending a mix of preferenceType values is not supported. For example, you cannot send an instance of CabinPreference with a preferenceType of Permitted and another instance with preferenceType of Prohibited. In this case the results default to the Preferred preference.
    Enum: "Preferred", "Permitted", "PreferredWithUpgrade", "Prohibited"

  - `CabinPreference.cabins` (array)
    A space-delimited list of cabins.
    Enum: "PremiumFirst", "First", "Business", "PremiumEconomy", "Economy"

  - `CabinPreference.legSequence` (array)
    Limits preference to the specified leg referenced in SearchCriteriaFlight. You can apply the preference to only some legs of the itinerary, or different preferences to different legs. To apply preference to the entire itinerary, do not send legSequence. GDS only, not supported for NDC. Not supported at Price or Book.
    Example: [1,2]

  - `lowFareFindAndRebookInd` (boolean)
    If true, the original flights in the reservation will be rebooked or replaced with the new exchanged flights.

## Response 201 fields (application/json):

  - `CatalogOfferingsAirChangeResponse` (object)
    The response of a Catalog offerings air change endpoint request.

  - `CatalogOfferingsAirChangeResponse.CatalogOfferings` (object)

  - `CatalogOfferingsAirChangeResponse.CatalogOfferings.@type` (string, required)
    Example: "CatalogOfferings"

  - `CatalogOfferingsAirChangeResponse.CatalogOfferings.id` (string)
    Local identifier within a given message for this object.
    Example: "CatalogOfferings_1"

  - `CatalogOfferingsAirChangeResponse.CatalogOfferings.Identifier` (object)
    A globally unique identifier key often used to reference a given option (such as Pricing, Booking, Rules, or additional workflows) or to retrieve information (such as Hotel pagination).

  - `CatalogOfferingsAirChangeResponse.CatalogOfferings.Identifier.value` (string)
    "Unique offer identifier that can be sent in subsequent payload requests to reference this offer.
When used specifically for form of payment, the value will begin with the characters 'FOP'. Similarly, the OfferIdentifier associated will begin with the character 'O'.
For Hotel Create Reservation (Reference Payload), send the value from the Availability response in CatalogOffering/id or the value from SearchComplete returned in propertyItems/lowestPublicAvailableRate/rateKey/value. 
Results from Availability and SearchComplete are stored in the cache for 30 minutes. If the offers expire before booking, you must send a new request."
    Example: "A0656EFF-FAF4-456F-B061-0161008D7C4E"

  - `CatalogOfferingsAirChangeResponse.CatalogOfferings.Identifier.authority` (string)
    "Name of the supplier system that created this identifier. 
For Hotels, authority indicates which supplier returned the lowest available rate for that property: either TVPT (Travelport) or BKNG (booking.com). Booking.com access requires additional provisioning and a direct agreement with the supplier. Authority is not returned if the property is closed or returns an error.
For Hotel Create Reservation (Full Payload) and Sync Reservation send the value from the Availability response in CatalogOffering/Identifier/authority for the instance you want to book."
    Example: "TVPT"

  - `CatalogOfferingsAirChangeResponse.CatalogOfferings.totalCatalogOffering` (integer)
    Total number of rates available for this request.

  - `CatalogOfferingsAirChangeResponse.CatalogOfferings.catalogOfferingPerPage` (integer)
    Total number of rates returned per page.

  - `CatalogOfferingsAirChangeResponse.CatalogOfferings.numberOfPages` (integer)
    Total number of pages created by this request.
    Example: 5

  - `CatalogOfferingsAirChangeResponse.CatalogOfferings.CatalogOffering` (array, required)

  - `CatalogOfferingsAirChangeResponse.CatalogOfferings.CatalogOffering.@type` (string, required)
    'Discriminator class for Hotel Availability is CatalogOfferingHospitality. 
Discriminator class for ExchangeSearch is CatalogOfferingModify.'
    Example: "CatalogOffering"

  - `CatalogOfferingsAirChangeResponse.CatalogOfferings.CatalogOffering.id` (string)
    "Unique offer identifier that can be sent in subsequent payload requests to reference this offer. 
For Hotel Availability, offers are cached for 30 minutes. If a Rules request or Reservation is not created within 30 minutes, a new Availability request must be sent."
    Example: "108c5875-c822-4d2e-bb9f-c96368100f4a:a709ffcdc1f681c5cf3f1d7da1a8ebfc"

  - `CatalogOfferingsAirChangeResponse.CatalogOfferings.CatalogOffering.CatalogOfferingRef` (string)
    Used to reference another instance of this object in the same message
    Example: "co1"

  - `CatalogOfferingsAirChangeResponse.CatalogOfferings.CatalogOffering.Identifier` (object)
    A globally unique identifier key often used to reference a given option (such as Pricing, Booking, Rules, or additional workflows) or to retrieve information (such as Hotel pagination).

  - `CatalogOfferingsAirChangeResponse.CatalogOfferings.CatalogOffering.ContentSource` (string)
    Indicates the owner the offer or document.
    Enum: "GDS", "NDC", "LCC", "API"

  - `CatalogOfferingsAirChangeResponse.CatalogOfferings.CatalogOffering.ProductOptions` (array, required)

  - `CatalogOfferingsAirChangeResponse.CatalogOfferings.CatalogOffering.ProductOptions.@type` (string, required)
    Discriminator classes ProductOptionsID and ProductOptions.
    Example: "ProductOptions"

  - `CatalogOfferingsAirChangeResponse.CatalogOfferings.CatalogOffering.ProductOptions.id` (string)
    Local identifier within a given message for this object.
    Example: "ProductOptions_1"

  - `CatalogOfferingsAirChangeResponse.CatalogOfferings.CatalogOffering.ProductOptions.Identifier` (object)
    A globally unique identifier key often used to reference a given option (such as Pricing, Booking, Rules, or additional workflows) or to retrieve information (such as Hotel pagination).

  - `CatalogOfferingsAirChangeResponse.CatalogOfferings.CatalogOffering.ProductOptions.ProductOptionsRef` (string)
    Used to reference another instance of this object in the same message
    Example: "ProductOptions_1"

  - `CatalogOfferingsAirChangeResponse.CatalogOfferings.CatalogOffering.ProductOptions.sequence` (integer)
    NonnegativeInteger
    Example: 1

  - `CatalogOfferingsAirChangeResponse.CatalogOfferings.CatalogOffering.ProductOptions.Product` (array, required)

  - `CatalogOfferingsAirChangeResponse.CatalogOfferings.CatalogOffering.ProductOptions.Product.@type` (string, required)
    Discriminator. Air Search child classes are ProductAir and ProductAncillary. Exchange Search child class is ProductAir. Ancillary Search is ProductAncillary. Seat Map child class isProductSeatAvailability. Air Price child classes are ProductAir and ProductAncillary. Hotel Availability child classes are ProductHospitality and ProductHospitalityOffer. Hotel Rules and HotelReservation child classes are ProductHospitality. All Vehicle APIs are ProductVehicle and ProductAncillaryVehicle. Reservation and Reservation Workbench child classes are ProductAir, ProductAncillary, ProductHospitality, ProductVehicle, and ProductAncillaryVehicle.
    Example: "ProductAir"

  - `CatalogOfferingsAirChangeResponse.CatalogOfferings.CatalogOffering.ProductOptions.Product.id` (string)
    Local id within a given message to support referencing this object.
    Example: "product_1"

  - `CatalogOfferingsAirChangeResponse.CatalogOfferings.CatalogOffering.ProductOptions.Product.productRef` (string)
    Reference id that corresponds to the product 'id' in ReferenceListProduct.Product. To find flight details for a product, use the ProductRef id to identify the product in ReferenceListProduct.Product, and use the Flight id's (e.g., s3, s4) to match to flight information in ReferenceListFlight.Flight.
    Example: "product_1"

  - `CatalogOfferingsAirChangeResponse.CatalogOfferings.CatalogOffering.ProductOptions.Product.Identifier` (object)
    A globally unique identifier key often used to reference a given option (such as Pricing, Booking, Rules, or additional workflows) or to retrieve information (such as Hotel pagination).

  - `CatalogOfferingsAirChangeResponse.CatalogOfferings.CatalogOffering.Price` (object, required)
    Child class of Price. This includes all of the Price object plus the Pricebreakdown which gives detailed Price information per PTC or Hotel offering.
For a Hotels Create Reservation (Full Payload) request, find the values to send in the Price objects from either Availability (returned in CatalogOffering/Price) or Rules (returned in Offer/Price). Although you can send the price returned in either API, the Rules pricing may be more accurate. If you sent a Rules request, send the value from that response. You must include CurrencyCode, Base, TotalTaxes, and TotalPrice. When returned from the previous steps, additionally send TermsAndConditionsFull, ProductRateCodeInfo, and RateCodeInfo.

  - `CatalogOfferingsAirChangeResponse.CatalogOfferings.CatalogOffering.Price.@type` (string, required)
    Discriminator classes Price or PriceDetail
    Example: "PriceDetail"

  - `CatalogOfferingsAirChangeResponse.CatalogOfferings.CatalogOffering.Price.id` (string)
    Internally referenced id
    Example: "2"

  - `CatalogOfferingsAirChangeResponse.CatalogOfferings.CatalogOffering.Price.CurrencyCode` (object)
    Currency codes are the three-letter alphabetic codes that represent the various currencies used throughout the world. 
For Hotel: SourceCurrency is based on the location of the hotel and used for all rates in the response. TargetCurrency is the currency code sent in the request in requestedCurrency.

  - `CatalogOfferingsAirChangeResponse.CatalogOfferings.CatalogOffering.Price.CurrencyCode.value` (string)
    An ISO 4217 currency code.
    Example: "USD"

  - `CatalogOfferingsAirChangeResponse.CatalogOfferings.CatalogOffering.Price.CurrencyCode.codeAuthority` (string)
    Currency code authority
    Example: "ISO 4217"

  - `CatalogOfferingsAirChangeResponse.CatalogOfferings.CatalogOffering.Price.CurrencyCode.decimalPlace` (integer)
    Number of decimal places for the currency.
    Example: 4

  - `CatalogOfferingsAirChangeResponse.CatalogOfferings.CatalogOffering.Price.CurrencyCode.decimalAuthority` (string)
    Currency code decimal authority
    Example: "ISO 4217"

  - `CatalogOfferingsAirChangeResponse.CatalogOfferings.CatalogOffering.Price.Base` (number)
    "Base price before taxes and fees. 
For Hotel, may not be returned by all suppliers."
    Example: 20.2

  - `CatalogOfferingsAirChangeResponse.CatalogOfferings.CatalogOffering.Price.TotalTaxes` (number)
    "Total taxes applied to the base price. 
For Hotel, may not be returned by all suppliers."
    Example: 34.4

  - `CatalogOfferingsAirChangeResponse.CatalogOfferings.CatalogOffering.Price.TotalFees` (number)
    Total fees included in Total Price.
    Example: 201

  - `CatalogOfferingsAirChangeResponse.CatalogOfferings.CatalogOffering.Price.TotalPrice` (number)
    Total price of this offer including the base price and all taxes and fees.
    Example: 34

  - `CatalogOfferingsAirChangeResponse.CatalogOfferings.CatalogOffering.Price.FlightPassCredits` (integer)
    The total number of flight pass credits consumed for this offer.
    Example: 2

  - `CatalogOfferingsAirChangeResponse.CatalogOfferings.CatalogOffering.Price.PriceBreakdown` (array)

  - `CatalogOfferingsAirChangeResponse.CatalogOfferings.CatalogOffering.Price.PriceBreakdown.@type` (string, required)
    Discriminator. Air Search and Air Price APIs child classes are PriceBreakdownAir and PriceBreakdownAncillary.Search Ancillaries and Seat Availabilities child classes are PriceBreakdown, PriceBreakdownAncillary, and PriceBreakdownAncillaryAir. All Hotel API child classes are PriceBreakdownHospitality.Vehicle API child classes are PriceBreakdownVehicleCharges, PriceBreakdownVehicleDeposit, PriceBreakdownVehiclePrice, and PriceBreakdownAncillaryVehicle. Reservation and Reservation Workbench APIs are PriceBreakdownAir, PriceBreakdownAncillary, PriceBreakdownHospitality, PriceBreakdownVehicleCharges, PriceBreakdownVehicleDeposit, PriceBreakdownVehiclePrice, and PriceBreakdownAncillaryVehicle.
    Example: "PriceBreakdownAir"

  - `CatalogOfferingsAirChangeResponse.CatalogOfferings.CatalogOffering.Price.PriceBreakdown.Amount` (object)
    Amount represents the cost applied

  - `CatalogOfferingsAirChangeResponse.CatalogOfferings.CatalogOffering.Price.PriceBreakdown.Amount.@type` (string)

  - `CatalogOfferingsAirChangeResponse.CatalogOfferings.CatalogOffering.Price.PriceBreakdown.Amount.currencySource` (string)
    The system requesting or returning the currency code specified in the attribute
    Enum: "Supplier", "Charged", "Requested"

  - `CatalogOfferingsAirChangeResponse.CatalogOfferings.CatalogOffering.Price.PriceBreakdown.Amount.CurrencyCode` (object)
    Currency codes are the three-letter alphabetic codes that represent the various currencies used throughout the world. 
For Hotel: SourceCurrency is based on the location of the hotel and used for all rates in the response. TargetCurrency is the currency code sent in the request in requestedCurrency.

  - `CatalogOfferingsAirChangeResponse.CatalogOfferings.CatalogOffering.Price.PriceBreakdown.Amount.Base` (number)
    The base price prior to all applicable taxes or fees of a product, such as the amount for a room or fare for a flight.
    Example: 120.2

  - `CatalogOfferingsAirChangeResponse.CatalogOfferings.CatalogOffering.Price.PriceBreakdown.Amount.Taxes` (object)
    Summary of all individual taxes. Child class TaxesDetail provides the breakdown of individual taxes.

  - `CatalogOfferingsAirChangeResponse.CatalogOfferings.CatalogOffering.Price.PriceBreakdown.Amount.Fees` (object)
    Includes TotalFees object to return the sum total of any fees. Child class FeesDetail includes a breakdown of the individual fees.

  - `CatalogOfferingsAirChangeResponse.CatalogOfferings.CatalogOffering.Price.PriceBreakdown.Amount.Total` (number)
    "Specifies the total price including base + taxes + fees. 
In PriceBreakdownHospitality, this total is for a given group of nights. 
In PriceBreakdownAir this is the total for one passenger of this PTC type."
    Example: 230.13

  - `CatalogOfferingsAirChangeResponse.CatalogOfferings.CatalogOffering.Price.PriceBreakdown.Amount.approximateInd` (boolean)
    if true this amount has been converted from the original amount
    Example: true

  - `CatalogOfferingsAirChangeResponse.CatalogOfferings.CatalogOffering.Price.PriceBreakdown.Commission` (object)
    Commission information. In Air Search commission is returned for GDS only; not supported for NDC. Any commission filed by an airline in a CAT35 fare is returned in PriceBreakdownAir/Commission. The amount is either a percent of the fare component (@type CommissionPercent and the Percent object) or an amount (@type CommissionAmount and the Amount object).

  - `CatalogOfferingsAirChangeResponse.CatalogOfferings.CatalogOffering.Price.PriceBreakdown.Commission.@type` (string, required)
    Discriminator. Child classes CommissionAmount or CommissionPercent
    Example: "CommissionAmount"

  - `CatalogOfferingsAirChangeResponse.CatalogOfferings.CatalogOffering.Price.PriceBreakdown.Commission.application` (string)
    Type of commission
    Enum: "Full", "Partial", "Non-paying", "No-show", "Adjustment", "Commissionable"

  - `CatalogOfferingsAirChangeResponse.CatalogOfferings.CatalogOffering.Price.VendorCurrencyTotal` (object)
    No longer used. Previously used to expose the local vendor currency when it is different to the purchased currency

  - `CatalogOfferingsAirChangeResponse.CatalogOfferings.CatalogOffering.Price.VendorCurrencyTotal.@type` (string)

  - `CatalogOfferingsAirChangeResponse.CatalogOfferings.CatalogOffering.Price.VendorCurrencyTotal.currencySource` (string)
    The system requesting or returning the currency code specified in the attribute
    Enum: "Supplier", "Charged", "Requested"

  - `CatalogOfferingsAirChangeResponse.CatalogOfferings.CatalogOffering.Price.VendorCurrencyTotal.CurrencyCode` (object)
    Currency codes are the three-letter alphabetic codes that represent the various currencies used throughout the world. 
For Hotel: SourceCurrency is based on the location of the hotel and used for all rates in the response. TargetCurrency is the currency code sent in the request in requestedCurrency.

  - `CatalogOfferingsAirChangeResponse.CatalogOfferings.CatalogOffering.Price.VendorCurrencyTotal.Base` (number)
    The price prior to all applicable taxes of a product such as the rate for a room or fare for a flight.
    Example: 120.2

  - `CatalogOfferingsAirChangeResponse.CatalogOfferings.CatalogOffering.Price.VendorCurrencyTotal.Taxes` (object)
    Summary of all individual taxes. Child class TaxesDetail provides the breakdown of individual taxes.

  - `CatalogOfferingsAirChangeResponse.CatalogOfferings.CatalogOffering.Price.VendorCurrencyTotal.Fees` (object)
    Includes TotalFees object to return the sum total of any fees. Child class FeesDetail includes a breakdown of the individual fees.

  - `CatalogOfferingsAirChangeResponse.CatalogOfferings.CatalogOffering.Price.VendorCurrencyTotal.Total` (number)
    Specifies the total price including base + taxes + fees
    Example: 30.13

  - `CatalogOfferingsAirChangeResponse.CatalogOfferings.CatalogOffering.Price.VendorCurrencyTotal.approximateInd` (boolean)
    True if this amount has been converted from the original amount
    Example: true

  - `CatalogOfferingsAirChangeResponse.CatalogOfferings.CatalogOffering.TermsAndConditions` (object)
    Terms And Conditions that apply to an offer.

  - `CatalogOfferingsAirChangeResponse.CatalogOfferings.CatalogOffering.TermsAndConditions.@type` (string, required)
    Discriminator. Air Search child classes are TermsAndConditionsAir and TermsAndConditionsAncillary. Exchange Search child class is TermsAndConditionsAirChange. Search Ancillaries and Seat Availabilities child classes are TermsAndConditions, TermsAndConditionsAncillary, and TermsAndConditionsAncillaryAir. Hotel Availability child class is TermsAndConditionsHospitality.
    Example: "TermsAndConditionsAir"

  - `CatalogOfferingsAirChangeResponse.CatalogOfferings.CatalogOffering.TermsAndConditions.id` (string)
    Local id within a given message to support referencing this object. For Air Search APIs, matches to the reference value in ProductBrandOffering/TermsAndConditions/termsAndConditionsRef in instances of ProductBrandOptions.
    Example: "TC_1"

  - `CatalogOfferingsAirChangeResponse.CatalogOfferings.CatalogOffering.TermsAndConditions.termsAndConditionsRef` (string)
    Reference id that corresponds to the TermsAndConditions 'id' in ReferenceListTermsAndConditions.TermsAndConditions.
    Example: "TC_1"

  - `CatalogOfferingsAirChangeResponse.CatalogOfferings.CatalogOffering.TermsAndConditions.Identifier` (object)
    A globally unique identifier key often used to reference a given option (such as Pricing, Booking, Rules, or additional workflows) or to retrieve information (such as Hotel pagination).

  - `CatalogOfferingsAirChangeResponse.CatalogOfferings.CatalogOffering.TermsAndConditions.ExpiryDate` (string)
    The date and time the offer will expire. Not returned in GDS Search. NDC generally allows 20 to 30 minutes to create a booking (the offer time limit). That time limit varies by airline and is returned here in the Search response.
    Example: "2022-08-07 12:12:00+00:00"

  - `CatalogOfferingsAirChangeResponse.CatalogOfferings.CatalogOffering.TermsAndConditions.CustomerLoyalty` (array)

  - `CatalogOfferingsAirChangeResponse.CatalogOfferings.AncillaryOffering` (array)

  - `CatalogOfferingsAirChangeResponse.CatalogOfferings.AncillaryOffering.@type` (string, required)
    Discriminator classes AncillaryOfferingID and AncillaryOffering
    Example: "AncillaryOffering"

  - `CatalogOfferingsAirChangeResponse.CatalogOfferings.AncillaryOffering.id` (string)
    Local identifier within a given message for this object.

  - `CatalogOfferingsAirChangeResponse.CatalogOfferings.AncillaryOffering.CatalogOfferingRef` (string)
    Used to reference another instance of this object in the same message

  - `CatalogOfferingsAirChangeResponse.CatalogOfferings.AncillaryOffering.AncillaryOfferingRef` (string)

  - `CatalogOfferingsAirChangeResponse.CatalogOfferings.AncillaryOffering.Identifier` (object)
    A globally unique identifier key often used to reference a given option (such as Pricing, Booking, Rules, or additional workflows) or to retrieve information (such as Hotel pagination).

  - `CatalogOfferingsAirChangeResponse.@type` (string)
    Example: "response"

  - `CatalogOfferingsAirChangeResponse.transactionId` (string)
    "A unique system-generated (128 bit GUID format) transaction/tracking id for a single request and response (i.e. for a single transaction) used for internal tracking and troubleshooting. Also known as E2ETrackingId. Not returned in all Hotel API responses."
    Example: "49f58f5f-c443-43b4-9f5d-be405fd00a01"

  - `CatalogOfferingsAirChangeResponse.traceId` (string)
    "Used in hospitality workflows to provide a Unique transaction or tracking id for a single request and response. For Rules, returned if a custom trace ID was sent in the request header"
    Example: "TraceID_123456"

  - `CatalogOfferingsAirChangeResponse.correlationId` (string)
    Identifier used to correlate hotel API invocations across a multi-call business flow.

  - `CatalogOfferingsAirChangeResponse.reservationStatus` (string)
    Status of reservation or offer completion.
    Enum: "Success", "Fail", "Partial", "Pending", "OnHold", "Retry", "Other"

  - `CatalogOfferingsAirChangeResponse.Result` (object)
    Returns the error and/or warning message information, if applicable.

  - `CatalogOfferingsAirChangeResponse.Result.@type` (string)
    Discriminator class Result only
    Example: "Result"

  - `CatalogOfferingsAirChangeResponse.Result.status` (string)
    The status of an error or warning
    Enum: "Not processed", "Incomplete", "Complete", "Unknown"

  - `CatalogOfferingsAirChangeResponse.Result.Error` (array)
    A list of error information returned at the provider level for a response.

  - `CatalogOfferingsAirChangeResponse.Result.Error.@type` (string, required)
    Discriminator classes Error or ErrorDetail
    Example: "ErrorDetail"

  - `CatalogOfferingsAirChangeResponse.Result.Error.Message` (string)
    The Travelport standardized error or warning message
    Example: "No flights found."

  - `CatalogOfferingsAirChangeResponse.Result.Error.NameValuePair` (array)

  - `CatalogOfferingsAirChangeResponse.Result.Error.NameValuePair.value` (string)
    Text directly related to name description, providing more detail. May have character restrictions based on remark type (e.g. Free Text limitations: 84 characters, alphanumeric and some special characters).
    Example: "Sunday"

  - `CatalogOfferingsAirChangeResponse.Result.Error.NameValuePair.id` (string)
    Optional internally referenced id
    Example: "6"

  - `CatalogOfferingsAirChangeResponse.Result.Error.NameValuePair.name` (string, required)
    Key, categorizing the of type of remark or error.
    Example: "Day1"

  - `CatalogOfferingsAirChangeResponse.Result.Error.StatusCode` (integer)
    Http standard response code
    Example: 200

  - `CatalogOfferingsAirChangeResponse.Result.Warning` (array)
    A list of warning information returned at the provider level for a response.

  - `CatalogOfferingsAirChangeResponse.Result.Warning.@type` (string, required)
    Discriminator classes Warning or WarningDetail
    Example: "WarningDetail"

  - `CatalogOfferingsAirChangeResponse.Result.Warning.Message` (string)
    The Travelport standardized error or warning message
    Example: "Customer Loyalty could not be applied."

  - `CatalogOfferingsAirChangeResponse.Result.Warning.NameValuePair` (array)

  - `CatalogOfferingsAirChangeResponse.Result.Warning.StatusCode` (integer)
    Http standard response code
    Example: 200

  - `CatalogOfferingsAirChangeResponse.Identifier` (object)
    A globally unique identifier key often used to reference a given option (such as Pricing, Booking, Rules, or additional workflows) or to retrieve information (such as Hotel pagination).

  - `CatalogOfferingsAirChangeResponse.NextSteps` (object)
    Container for the steps that describe actions that may be taken on the containing object.

  - `CatalogOfferingsAirChangeResponse.NextSteps.baseURI` (string, required)
    The base portion of the uri in order to shorten the uris in the individual steps

  - `CatalogOfferingsAirChangeResponse.NextSteps.id` (string)
    Optional internally referenced id
    Example: "5"

  - `CatalogOfferingsAirChangeResponse.NextSteps.NextStep` (array, required)

  - `CatalogOfferingsAirChangeResponse.NextSteps.NextStep.value` (string)
    Example: "www.resourcelocation.com"

  - `CatalogOfferingsAirChangeResponse.NextSteps.NextStep.id` (string)
    Identifier for the Next Step
    Example: "2"

  - `CatalogOfferingsAirChangeResponse.NextSteps.NextStep.action` (string, required)
    The action this next step is intended to achieve
    Example: "cancel"

  - `CatalogOfferingsAirChangeResponse.NextSteps.NextStep.method` (string, required)
    Describes the set of potential methods that can be taken after an operation.
    Enum: "GET", "DELETE", "PUT", "POST"

  - `CatalogOfferingsAirChangeResponse.NextSteps.NextStep.description` (string)
    Additional clarification for the next step
    Example: "remove offer from the order"

  - `CatalogOfferingsAirChangeResponse.ReferenceList` (array)

  - `CatalogOfferingsAirChangeResponse.ReferenceList.@type` (string, required)
    Discriminator. Air Search child classes are ReferenceListAmenity, ReferenceListBrand, ReferenceListFlight, ReferenceListProduct, ReferenceListTermsAndConditions, and ReferenceListUniversalProductAttribute. Air Price child classes are ReferenceListAmenity and ReferenceListBrand. FareRules child class is ReferenceListFlight. Search Ancillaries child class is ReferenceListFlight. Seat Map child class is ReferenceListSeatingChart. Hotel Availability child class is ReferenceListPropertyDates. Reservation and Reservation Workbench child classes are ReferenceListAmenity, ReferenceListBrand, and ReferenceListUniversalProductAttribute. Exchange Search child classes are ReferenceListBrand, ReferenceListFlight, and ReferenceListExchangedPrice. Reservation Receipt child classes are ReferenceListOffer and ReferenceListTraveler. Book_Traveler child class is ReferenceListTraveler.
    Example: "ReferenceListFlight"

  - `CatalogOfferingsAirChangeResponse.ReferenceList.id` (string)
    Uniquely identifies for the Reference List

  - `CatalogOfferingsAirChangeResponse.CurrencyRateConversion` (array)

  - `CatalogOfferingsAirChangeResponse.CurrencyRateConversion.@type` (string)

  - `CatalogOfferingsAirChangeResponse.CurrencyRateConversion.SourceCurrency` (object, required)
    Currency codes are the three-letter alphabetic codes that represent the various currencies used throughout the world. 
For Hotel: SourceCurrency is based on the location of the hotel and used for all rates in the response. TargetCurrency is the currency code sent in the request in requestedCurrency.

  - `CatalogOfferingsAirChangeResponse.CurrencyRateConversion.TargetCurrency` (object, required)
    Currency codes are the three-letter alphabetic codes that represent the various currencies used throughout the world. 
For Hotel: SourceCurrency is based on the location of the hotel and used for all rates in the response. TargetCurrency is the currency code sent in the request in requestedCurrency.

  - `CatalogOfferingsAirChangeResponse.CurrencyRateConversion.ConversionRate` (object, required)
    Conversion rate of SourceCurrency value to TargetCurrency value. This value can be used to calculate, independently of the API, conversion for the rates in the response. The response does not convert any amounts.

  - `CatalogOfferingsAirChangeResponse.CurrencyRateConversion.ConversionRate.value` (number)

  - `CatalogOfferingsAirChangeResponse.CurrencyRateConversion.ConversionRate.rateAuthority` (string)
    Contextual rate authority
    Example: "ISO 4217"

  - `CatalogOfferingsAirChangeResponse.CurrencyRateConversion.ConversionRate.rateAsOf` (string)
    Rate as of
    Example: "2026-08-07 12:12:00+00:00"

  - `CatalogOfferingsAirChangeResponse.Pagination` (object)
    Pagination object used when result sets span across a number of pages.

  - `CatalogOfferingsAirChangeResponse.Pagination.@type` (string, required)
    Example: "Pagination"

  - `CatalogOfferingsAirChangeResponse.Pagination.page` (integer, required)
    The current page number of the full result set
    Example: 1

  - `CatalogOfferingsAirChangeResponse.Pagination.pageSize` (integer, required)
    The total number of items on this page
    Example: 20

  - `CatalogOfferingsAirChangeResponse.Pagination.totalPages` (integer, required)
    The total number of pages in this result set
    Example: 5

  - `CatalogOfferingsAirChangeResponse.Pagination.totalItems` (integer, required)
    The total number of pages in this result set
    Example: 100

## Response 400 fields (application/json):

  - `ErrorResponse` (object)
    Base common error response

  - `ErrorResponse.@type` (string)
    Example: "response"

  - `ErrorResponse.transactionId` (string)
    "A unique system-generated (128 bit GUID format) transaction/tracking id for a single request and response (i.e. for a single transaction) used for internal tracking and troubleshooting. Also known as E2ETrackingId. Not returned in all Hotel API responses."
    Example: "49f58f5f-c443-43b4-9f5d-be405fd00a01"

  - `ErrorResponse.traceId` (string)
    "Used in hospitality workflows to provide a Unique transaction or tracking id for a single request and response. For Rules, returned if a custom trace ID was sent in the request header"
    Example: "TraceID_123456"

  - `ErrorResponse.correlationId` (string)
    Identifier used to correlate hotel API invocations across a multi-call business flow.

  - `ErrorResponse.reservationStatus` (string)
    Status of reservation or offer completion.
    Enum: "Success", "Fail", "Partial", "Pending", "OnHold", "Retry", "Other"

  - `ErrorResponse.Result` (object)
    Returns the error and/or warning message information, if applicable.

  - `ErrorResponse.Identifier` (object)
    A globally unique identifier key often used to reference a given option (such as Pricing, Booking, Rules, or additional workflows) or to retrieve information (such as Hotel pagination).

  - `ErrorResponse.NextSteps` (object)
    Container for the steps that describe actions that may be taken on the containing object.

  - `ErrorResponse.ReferenceList` (array)

  - `ErrorResponse.CurrencyRateConversion` (array)

  - `ErrorResponse.Pagination` (object)
    Pagination object used when result sets span across a number of pages.