---
title: "AirPrice Full Payload"
method: POST
path: "/air/price/offers/buildfromproducts"
tags: ["Pricing and Fare Rules"]
---

# AirPrice Full Payload

`POST /air/price/offers/buildfromproducts`

## Request

- Base URL: `https://api.pp.travelport.net/11`
- URL: `https://api.pp.travelport.net/11/air/price/offers/buildfromproducts`
- Auth: HTTP bearer

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 NDC carriers.

## Headers

- `travelportPlusSessionIdentifier` string
- `TraceId` string
- `XAUTH_TRAVELPORT_ACCESSGROUP` string
- `TVP-PCC-Core` string

## Request body

- OfferQueryBuildFromProducts: Used for AirPrice and Add Offer full-payload requests. Defines the top-level request for building an offer from full itinerary details, together with optional cabin, payment, fare rule, branding, inventory, and upsell controls. The full payload request sends full itinerary details without a reference to any previous search. In pricing workflows, this request is used to confirm pricing for a supplied itinerary without using a cache to reference a prior Search response. It can be used to price an itinerary returned from the Search API or from a non-Travelport source. For NDC, only specific NDC carriers support the AirPrice full payload request. In booking workflows, it is used to add a supplied itinerary to the reservation workbench as an offer.
  - `@type` string, required: Discriminator. No child classes
  - `BuildFromProductsRequest` BuildFromProductsRequest: GDS only. Not supported for NDC. Full payload itinerary request used in multiple work flows. Flight Specific Search, Full payload Price, Full payload Book.
    - `@type` string, required: Discriminator. - Next Leg Search and AirPrice child classes BuildFromProductsRequestAir, BuildFromProductsRequestAirSearch, and BuildFromProductsRequestOfferConstruction - To price all PTCs and segments send with @type BuildFromProductsRequestAir. - To price a specific PTC and/or air segment, send with @type BuildFromProductsRequestOfferConstruction - TripChange child class is BuildFromProductsRequestAirChange
  - `CabinPreference` CabinPreference: Requests a fare based on the cabin class. Only one cabin preferenceType (Permitted, Preferred, PreferredWithUpgrade) is allowed per request, but there is no limit to the number of cabins that can be sent. - Any CabinPreference in the initial Search request is applied to any subsequent Next Leg Search and reference Flight Specific Search requests. - In AirPrice and AirReservation only one cabin preference type is allowed per request, but there is no limit to the number of cabins that can be sent. If CabinPreference was sent in the Search request, it is cached and sent with the AirPrice reference payload request. If you send CabinPreference in the AirPrice request, all cached modifiers are discarded and only the modifiers sent in the AirPrice request are used. Can be combined with lowFareFinderInd=true to return lowest fare in the requested cabin or cabins. When using CabinPreference and lowFareFinderInd, if both CabinPreference and a class of service are sent, class of service is ignored. If CabinPreference is sent without a class of service, the response returns the lowest fare in the cabin requested. If that cabin is not available, the response may upgrade or downgrade to a different cabin. If a different cabin than requested is returned, the response returns the message that the cabin class may differ from the class requested. If lowFareFinderInd=false and CabinPreference are sent in the request, AirPrice ignores the preferred cabin and returns a message that the preferred cabin was ignored. If CabinPreference is set to All, no cabin preference is applied.
    - `@type` string, required: Discriminator. No child classes exist
    - `preferenceType` 'Preferred' | 'Permitted' | 'PreferredWithUpgrade' | 'Prohibited': Type of cabin preference. 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. Note that if lowFareFinderInd is sent with true and CabinPreference is sent, the only supported value for CabinPreference/type is Permitted.
    - `cabins` CabinAirEnum[]: A space-delimited list of cabins.
    - `legSequence` integer[]: Leg level preference is supported only for CarrierPreference, CabinPreference, and ClassOfServicePreference. Not supported at AirPrice or Book. Limits preference to the specified leg. You can apply the preference to only some legs of the itinerary, or different preferences to different legs. Best practice is to also send legSequence in SearchCriteriaFlight. To apply preference to the entire itinerary, do not send legSequence.
  - `PaymentCriteria` PaymentCriteria: Optional object to send the BIN/INN (IssuerIdentificationNumber) of the credit card to be used for payment; sending the BIN returns OB fees in the response Required when using Air Canada flight pass.
    - `@type` string, required: discriminator
    - `IssuerIdentificationNumber` string: Required if PaymentCriteria sent; 6 to 16 characters inclusive are accepted. The BIN/IssuerIdentificationNumber (IIN) of the credit card to be used for payment and returning OB fees. OB fees are ticketing and form of payment (FOP) charges, including credit card fees. Returned in an instance of Price/PriceBreakdown/Fees/Fee with a feeCode of OB. For NDC carrier BA, you must send the complete 16-digit credit card number to return the surcharge amount.
    - `PaymentCardCode` string: A two character code for a credit card
    - `DocumentNumber` DocumentNumber[]
      - `value` string
      - `documentIssuer` string: Document issuer
      - `documentType` 'EMD' | 'MCO' | 'Ticket' | 'TASF' | 'Invoice': Document type like EMD, MCO
      - `travelerIdentifierRef` string: traveler identifier reference
      - `name` string: The name of the Traveler being referenced.
      - `passengerTypeCode` string: The passenger type code of the Traveler being referenced.
      - `id` string: A locally referenced ID
      - `description` string: Descriptive text used to identify the contents of a target object
      - `uris` string[]: The URI used to GET the target object in another domain.
    - `FlightPass` FlightPass[]: 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. Required when using a flight pass to pay for an Air Canada NDC booking. Only one instance allowed. Refer to the [Air Canada Flight Pass](https://developer.travelport.com/docs/flights/ndc/ndc-guide-for-air-canada-flight-pass) section of the NDC Guide for more information
      - `@type` string, required: Discriminator. No child classes
      - `accountNumber` string, required: The flight pass account number.
      - `supplier` string, required: The flight pass supplier code. AC is the only value accepted at this time.
      - `Description` string[]
      - `TravelerIdentifierRef` TravelerIdentifierRef[]: In Search, use the passengerCriteriaRef to reference the owner of the flightpass. This is a mandatory field for Search API.
        - `value` string
        - `id` string: A locally referenced ID
        - `description` string: Descriptive text used to identify the contents of a target object
        - `uris` string[]: Uniform Resource Identifier
    - `agencyAccountInd` boolean: If true, payment will be made by agency account
    - `bspInd` boolean: If true, payment will be made by BSP
    - `cashInd` boolean: If true, payment will be made by cash
    - `invoiceInd` boolean: If true, payment will be made by invoice
  - `FareRuleType` 'Structured' | 'ShortText' | 'LongText': Use not recommended; request fare rules using the Fare Rules API request instead. Returns fare rules in the offer response. Structured rules limit the rules returned to one or more of these categories: advance reservation/ticketing requirements, minimum/maximum stay, stopovers, penalties, voluntary exchanges and refunds. GDS supports all categories; NDC supports only penalties. See the [Fare Rules Guide](https://developer.travelport.com/docs/flights/guides/fare-rules-guide) for details. Note that even if fare rules are not requested, for GDS only, change and cancel penalties are returned unless suppressed by sending CustomResponseModifiersAir/excludePenaltiesInd set to true. Not supported in BuildOptions (Flight Specific Search).
  - `FareRuleCategory` FareRuleCategoryEnum[]: Not recommended to use. Invoke fare rule end points directly.
  - `lowFareFinderInd` boolean: GDS only; not supported for NDC. Provides pricing flexibility around 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. - If false (default behavior): the response returns fares only in the requested class of service. Notes for modifier interations: - 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 with 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.
  - `returnBrandedFaresInd` boolean: Use to request the return of branded fares, which by default are not returned for the AirPrice Full Payload request. - If true, returns branded fares. For AirPrice this is supported only in the full payload request. - If false (default behavior): Does not return branded fares.
  - `reCheckInventoryInd` boolean: GDS only, not supported for NDC (NDC carriers always validate inventory at pricing). Sets whether to validate inventory on the first flight in the itinerary in the requested class of service by booking and then releasing seats. Can help reduce sell failures at booking by alerting of insufficient availability. - If true, verifies availability for the requested number of passengers in a specific class of service at the time of the price request by booking and releasing seats. If any or all segments are not bookable, AirPrice returns a message that the air segment/s are not bookable along with the dates and city pairs of the segments that are not bookable. - If false (default behavior): Checks only for general seat availability on the flight, not a specific class of service. Because this indicator temporarily affects seat availability, the recommended best practice is to use validateInventoryInd instead. Some airlines monitor for high volumes of sell/ignore transactions. Regardless of pricing results, air fares and inventory are only guaranteed by airlines when ticketed and paid. To cause AirPrice to perform the same check for connecting flights, you can send both reCheckInventory=true and SpecificFlightCriteria/boundFlightsInd=true for each connecting flight.
  - `validateInventoryInd` boolean: GDS only; not supported for NDC, as NDC carriers already validate inventory at pricing. Sets whether to validate inventory in the requested class of service. - If true, checks for availability for the requested number of passengers in the requested class of service at the time of the price request. If there are fewer seats than requested passengers available in that class of service, AirPrice does not return any offers and instead returns an error message that the booking class or preference is not available. This reduces failures at the Add Offer and Workbench Commit steps. - If false (default behavior): Checks only for general seat availability on the flight, not a specific class of service. AirPrice may return upsell offers with no availability in the requested class of service.
  - `MaxNumberOfUpsellsToReturn` integer: NDC only; not supported for GDS. Supports values from 0 to 99 inclusive. Send to request upsell offers along with pricing for the requested class of service or cabin, returned in ascending price order. An upsell is the next highest fare in a different brand or cabin than requested. Upsells are returned as follows: - Upsells not requested: Only the requested offer is returned. - One upsell requested: The lowest priced offer in the requested class of service or cabin plus one upsell offer are returned. - Two upsells requested (and so on for x upsells requested): The lowest priced offer in the requested class of service or cabin plus two upsell offers are returned.

## Response `200`

OK - Successful Response - 200

- OfferListResponseWrapper: Wrapper schema to expose the name of the top level schema in the JSON example
  - `OfferListResponse` OfferListResponse: Base response is part of all TripServices responses and includes common items which are relevant across all APIs
    - `@type` string
    - `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.
    - `traceId` string: Used in hospitality workflows to provide a unique transaction or tracking id for a single request and response. For Air Eligibility, returned if a custom trace ID was sent in the request header. For Hotel Rules, returned if a custom trace ID was sent in the request header.
    - `correlationId` string, uuid: Identifier used to correlate hotel API invocations across a multi-call business flows.
    - `reservationStatus` 'Success' | 'Fail' | 'Partial' | 'Pending' | 'OnHold' | 'Retry' | 'Other': Status of reservation or offer completion.
    - `Result` Result: Returns the error and/or warning message information, if applicable.
      - `@type` string: Discriminator class Result only
      - `status` 'Not processed' | 'Incomplete' | 'Complete' | 'Unknown': The status of an error or warning
      - `Error` Error[]: A list of error information returned at the provider level for a response.
        - `@type` string, required: Discriminator classes Error or ErrorDetail
        - `StatusCode` integer: Http standard response code
        - `Message` string: The Travelport standardized error or warning message
        - `NameValuePair` 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).
          - `id` string: Optional internally referenced id
          - `name` string, required: Key, categorizing the type of remark or error.
      - `Warning` Warning[]: A list of warning information returned at the provider level for a response.
        - `@type` string, required: Discriminator classes Warning or WarningDetail
        - `StatusCode` integer: Http standard response code
        - `Message` string: The Travelport standardized error or warning message
        - `NameValuePair` 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).
          - `id` string: Optional internally referenced id
          - `name` string, required: Key, categorizing the type of remark or error.
    - `Identifier` Identifier: 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).
      - `value` string: Unique offer identifier that can be sent in subsequent payload requests to reference this offer. When used for reference flight calls, the CatalogProductOfferingsIdentifier will be the transaction identifier from the Search, Next Leg Search, or Flight Specific Search response in CatalogProductOfferings/Identifier/value. If you choose to pull the CatalogProductOfferingsIdentifier from the Price response instead (OfferListResponse/Identifier/value), either full or reference payload, please note for subsequent Add Offer requests you must remove the _PC appended to the end of the value in the AirPrice response (e.g., change value: '93d2091d-3d04-48ab-8091-6ae1525f02ea_PC' to value: '93d2091d-3d04-48ab-8091-6ae1525f02ea'). When building an AirPrice or Add Offer reference payload request: - Look for the CatalogProductOfferingIdentifier (ex: o1) in a Search response at CatalogProductOfferings/CatalogProductOffering/id or a Price response at OfferListResponse/OfferID/id. - Look for the ProductIdentifier (ex: p0) in a Search response at CatalogProductOfferings/CatalogProductOffering/ProductBrandOptions/ProductBrandOffering/Product/productRef or from a Price response at OfferListResponse/OfferID/Product/id. When returned from a Workbench, this value is the workbench identifier that must be sent in all subsequent requests for this workbench session. When returned from Air Exchange Eligibility, value is the ticket number sent with the eligibility request. 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 Hotel Availability and Hotel SearchComplete are stored in the cache for 30 minutes. If the offers expire before booking, you must send a new request.
      - `authority` string: Name of the supplier system that created this identifier - the source of information. For AirPrice, please note that GDS offers return the value 'Travelport' in authority while NDC offers return the carrier code of the issuing NDC carrier. When returned from Air Exchange Eligibility, authority is always 'Travelport' as the transaction issuer. 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.
    - `NextSteps` NextSteps: Container for the steps that describe actions that may be taken on the containing object. Not applicable for an Eligibility or Exchange response.
      - `baseURI` string, required: The base portion of the URI in order to shorten the uris in the individual steps
      - `id` string: Optional internally referenced id
      - `NextStep` NextStep[], required
        - `value` string
        - `id` string: Identifier for the Next Step
        - `action` string, required: The action this next step is intended to achieve
        - `method` 'GET' | 'DELETE' | 'PUT' | 'POST', required: Describes the set of potential methods that can be taken after an operation.
        - `description` string: Additional clarification for the next step
    - `ReferenceList` 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.
      - `id` string: Uniquely identifies for the Reference List
    - `CurrencyRateConversion` CurrencyRateConversion[]
      - `@type` string
      - `SourceCurrency` CurrencyCode, required: Currency codes are the three-letter alphabetic codes that represent the various currencies used throughout the world. Unless changed in the request, the currency is the default associated with your provisioned PCC from Travelport. 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.
        - `value` string: An ISO 4217 currency code.
        - `codeAuthority` string: Currency code authority
        - `decimalPlace` integer: Number of decimal places for the currency.
        - `decimalAuthority` string: Currency code decimal authority
      - `TargetCurrency` CurrencyCode, required: Currency codes are the three-letter alphabetic codes that represent the various currencies used throughout the world. Unless changed in the request, the currency is the default associated with your provisioned PCC from Travelport. 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.
        - `value` string: An ISO 4217 currency code.
        - `codeAuthority` string: Currency code authority
        - `decimalPlace` integer: Number of decimal places for the currency.
        - `decimalAuthority` string: Currency code decimal authority
      - `ConversionRate` ConversionRate, 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.
        - `value` number, float
        - `rateAuthority` string: Contextual rate authority
        - `rateAsOf` string, date-time: Rate as of
    - `Pagination` Pagination: Pagination object used when result sets span across a number of pages.
      - `@type` string, required
      - `page` integer, required: The current page number of the full result set
      - `pageSize` integer, required: The total number of items on this page
      - `totalPages` integer, required: The total number of pages in this result set
      - `totalItems` integer, required: The total number of pages in this result set

## Other responses

- `400`: Bad Request - 400
- `401`: Unauthorized - 401
- `402`: Payment Required - 402
- `403`: Forbidden - 403
- `404`: Not Found - 404
- `500`: Internal Server Error - 500
- `503`: Service Unavailable - 503. This error may be returned when the service is temporarily unavailable due to infrastructure or network issues.

## Changes

- **2026-08-19** `90abcc916990`: 18 info
  - removed request discriminator
  - removed discriminator from `CabinPreference` request property
  - removed discriminator from `PaymentCriteria` request property
  - removed discriminator from `PaymentCriteria/FlightPass/items/` request property
  - …14 more

[Operation history](https://skmtc.dev/travelport/apis/tripservices-flights/changes/air/price/offers/buildfromproducts/post.md)

---

[API](https://skmtc.dev/travelport/apis/tripservices-flights.md) - [All operations](https://skmtc.dev/travelport/apis/tripservices-flights/llms.txt) - [OpenAPI document](https://skmtc.dev/travelport/apis/tripservices-flights/revisions/9e8fc967631f?raw)
