Unpriced Segment API Reference
|
POST |
book/airoffer/reservationworkbench/{workbenchID}/offers/unpricedsegments 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
Use the Unpriced Segment API in either the booking or post-booking workflow to add an unpriced segment to the workbench. When adding unpriced segments, the Unpriced Segment replaces the Add Offer API and adds an unpriced segment
An air segment without any associated fare or pricing, generally booked for availability versus cost. Shown in the UnpricedSegments object instead of the Offer object. GDS only; NDC does not use unpriced segments. instead of an offer, which is by definition priced.
GDS only; NDC does not support unpriced segments.
Request
As part of the request requirements, also see Authentication and Common Air Headers.
Query Parameters
None.
Request Body
|
Object |
Description |
Required/Optional |
|---|---|---|
|
UnpricedSegments |
Top level object for request. |
Required |
|
UnpricedFlightSegment |
Array. One instance for each unpriced segment to add. |
Required |
|
Sequence of the leg to add the segment for. |
Required |
|
Number. Number of passengers on this segment. |
Optional |
|
String. Class of service of the segment. |
Optional |
|
String. Send when adding a passive segment with the passive segment code. |
Optional |
|
Flight |
Array. One instance for each flight in the product. Standard Flight object, including Deaprtue and Arrival.
|
Required |
|
Departure |
Departure details. Key value pairs the location and date of arrival. |
Required |
|
Arrival |
Arrival details. Key value pairs are the location and date of arrival. |
Required |
Response
|
Object |
Description |
|---|---|
|
UnpricedSegmentsResponse |
Top level object for response. Key value pairs: |
|
Result |
Messages about the operation status. Key value pairs:
|
Example Request
{
"UnpricedSegments": {
"@type": "UnpricedSegments",
"UnpricedFlightSegment": [
{
"@type": "UnpricedFlightSegment",
"sequence": 1,
"passengerQuantity": 2,
"classOfService": "K",
"passiveSegmentStatus": "AK",
"Flight": {
"@type": "Flight",
"id": "1",
"carrier": "QF",
"number": "1251",
"Departure": {
"@type": "Departure",
"location": "BNE",
"date": "2025-11-30"
},
"Arrival": {
"@type": "Arrival",
"location": "MEL",
"date": "2025-11-30"
}
}
}
]
}
}
Example Response
{
"UnpricedSegmentsResponse": {
"transactionId": "1c6ebd45-0538-447a-b666-6e056f612d71",
"Result": {
"@type": "Result",
"status": "Complete"
}
}
}