Price Segments API Reference

POST

book/airoffer/reservationworkbench/{workbenchID}/offers/buildfromunpricedsegments

For {workbenchID} send the workbench identifier returned in ReservationResponse/Identifer/value in the workbench create response.

Base path:

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

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

Travelport has updated all JSON API authentication and authorization endpoints. The previous production endpoints will be deprecated 30 Jan 2026. Pre-production endpoints were deprecated 5 Dec 2025. See Endpoint Migration for details.

Related Content: Booking Guide

GDS only; NDC does not support unpriced segments.

You can use the Price Segments request to either:

  • auto-price one or more unpriced segments, detailed below

  • manually build a fare for one or more unpriced segments (implementation pending)

Each scenario uses its own request payload. Both payloads support auto-pricing/building one or multiple segments for one or multiple passengers on a booking.

To use the Price Segments API, you must have an existing booking with an unpriced segment. This unpriced segment could have been created or added to a booking with the Unpriced Segment API, or the unpriced segment could have been created by removing the filed fare from an offer with the Cancel Workbench Items API.

Request

As part of the request requirements, also see Authentication and Common Air Headers.

Query Parameters

None.

Request Body to Auto-price Segment

Object

Description

Required/Optional

OfferQueryBuildFromUnpricedSegments

Top level object.

Required

BuildfromUnpricedSegments

Send with @type BuildFromUnpricedSegmentsAutoPrice. See the AirPrice Full Payload API for details on the following optional indicators:

  • inhibitBrandContentInd

  • lowFareFinderInd

  • validateInventoryInd

  • lowFareFindAndRebookInd

Required

UnpricedFlightSegmentCriteria

Top level object.

Required

Sequence

Number. Send the sequence of this segment in the itinerary.

Required

TravelerRefs

Array. Send the traveler reference IDs for this segment.

Required

PricingModifiersAir

Send currency details.

Required

currencyCode

Send the currency code of the currency for pricing.

  

CustomReponseModifiersAir

Send empty object with @type CustomResponseModifiersAir.

Required

PaymentCriteria

Send empty object with @type PaymentCriteria.

Required

CabinPreference

Send standard CabinPreference object.

Optional

type

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

  • Permitted: ONLY the specified class or classes.
  • Preferred: Specified class or classes; lower classes if the specified class is not available.
  • PreferredWithUpgrade: Specified class or classes; will return higher classes if the specified class is not available.

Required if CabinPreference sent

cabins

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

  • Economy
  • PremiumEconomy
  • Business
  • First
  • PremiumFirst

Required if CabinPreference sent

legSequence

Number. The sequence number of the leg to which this preference applies.

Required if CabinPreference sent

Request Body to Manually Price Fare

Details pending upcoming release.

Response

Object

Description

OfferListResponse

Top level object for response.

Result

Messages about the operation status. Key value pairs:

status: String. Status of request.

Example Request

For additional examples, download the developer toolkits and see Using Postman and Developer Toolkits.
{
    "OfferQueryBuildFromUnpricedSegments": {
        "@type": "OfferQueryBuildFromUnpricedSegments",
        "BuildFromUnpricedSegments": [
            {
                "@type": "BuildFromUnpricedSegmentsAutoPrice",
                "inhibitBrandContentInd": true,
                "lowFareFinderInd": true,
                "validateInventoryInd": true,
                "lowFareFindAndRebookInd": true,
                "UnpricedFlightSegmentCriteria": [
                    {
                        "@type": "UnpricedFlightSegmentCriteria",
                        "UnpricedFlightSegmentRefs": [
                            "unPricedFlightSegment_1"
                        ],
                        "Sequence": 1,
                        "TravelerRefs": [
                            "travelerRefId_1"
                        ]
                    }
                ],
                "PricingModifiersAir": {
                    "@type": "PricingModifiersAir",
                    "currencyCode": "AUD"
                },
                "CustomResponseModifiersAir": {
                    "@type": "CustomResponseModifiersAir"
                },
                "PaymentCriteria": {
                    "@type": "PaymentCriteria"
                },
                "CabinPreference": [
                    {
                        "@type": "CabinPreference",
                        "preferenceType": "Preferred",
                        "cabins": [
                            "Business"
                        ],
                        "legSequence": [
                            1
                        ]
                    }
                ],
            }
        ]
    }
}

Example Response

For additional examples, download the developer toolkits and see Using Postman and Developer Toolkits.
{
    "OfferListResponse": {
        "Result": {
            "@type": "Result",
            "status": "Complete"
        }
    }
}