Post-Commit Workbench API Reference

POST

book/session/reservationworkbench/buildfromlocator?Locator={LocatorCode}

For {AggregatorLocatorCode} send the locator code returned at booking or in Reservation Retrieve in Receipt/Confirmation/Locator/value.

Hotel bookings return multiple locator codes. Send the value from the instance of Receipt with Confirmation/Locator/locatorType=PNR Locator. See Locator Codes for details.

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. Previous endpoints are scheduled for deprecation 5 Dec 2025 for pre-production and 30 Jan 2026 for production. You must migrate to the endpoints above before those dates or transactions in those environments will fail. See Endpoint Migration for details.

Related Content:Booking Guide, Ticketing Guide

Initiate a post-commit workbench to create a session for ticketing or updating an existing reservation. This is a prerequisite step for any workbench session to modify, update, or ticket a reservation.

Hotel and Car Content with Air Bookings

Reservation Retrieve and Post-Commit Workbench return air, hotel, and/or car segments for any reservation that includes that content, called a multi-content booking. All segments must have been booked with the JSON Air APIs, JSON Hotel APIs, JSON Car APIs (release pending), or a Travelport+ terminal program. You can add either GDS or NDC air offers to a hotel and/or car booking, but not both. See the Multi-content Booking Guide (Air, Hotel, Car) for workflows and examples.

Request

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

Query Parameters

Parameter Description Required/Optional

Locator

Send the reservation locator code in the Locator parameter.

 Required

Request Body

None.

Response

The response returns existing details in the reservation. The response is the same as for a Reservation Retrieve, plus a workbench ID in an additional Identifier object at the end of the response.

Object

Description

ReservationResponse

Top level object for response.

Includes Reservation and Identifier objects.

When a post-commit workbench is created, ReservationResponse is the same response returned in a Reservation Retrieve, plus the workbench identifier below. See Reservation Retrieve API Reference for a listing of all objects in ReservationResponse.

ReservationResponse/Identifier

 

Workbench identifier details. In this case authority is always Travelport, and value is the workbench identifier that must be sent in all subsequent requests for this workbench session.

authority: Source of information.

value: Unique system-generated identifier.

This workbench ID must be sent in all subsequent requests for this workbench session.

ReservationResponse/Reservation

Top-level object for reservation details.

Depending on the information already added to the reservation, may include Identifier, Offer, Traveler, Receipt, ReservationComment, and PrimaryContact objects. See Reservation Retrieve API Reference.

Example Request

This request does not use a message payload.

Example Response

The response returns the existing details in the booking, plus a workbench identifier at the end of the response in Identifier/value. This value would be sent in subsequent transactions to refer to this workbench.

For comparison purposes, note that the example booking shown here, with Travelport locator code BXPJVM, is also shown in the Commit Workbench API Reference example responses for both the booking and ticketing workbench commits, and in the Reservation Retrieve API Reference example for the ticketed one-way GDS Itinerary. 

{
 "ReservationResponse": {
  "@type": "ReservationResponse",
  "Reservation": {
   "@type": "Reservation",
   "Identifier": {
    "authority": "Travelport",
    "value": "1546cc57-c5c3-4670-b555-fed35dd69ddf"
   },
   "Offer": [
    {
     "@type": "Offer",
     "id": "offer_1",
     "Identifier": {
      "authority": "Travelport",
      "value": "9829d223-66dc-4590-8a8e-66a1669f8b00"
     },
     "ContentSource": "GDS",
     "Product": [
      {
       "@type": "ProductAir",
       "id": "product_1",
       "Identifier": {
        "authority": "Travelport",
        "value": "a9ddb86f-ec1a-42ba-8e78-3dafa208ab70"
       },
       "FlightSegment": [
        {
         "@type": "FlightSegment",
         "id": "FlightSegment_01",
         "sequence": 1,
         "Flight": {
          "@type": "Flight",
          "duration": "PT2H34M",
          "carrier": "AA",
          "number": "2755",
          "equipment": "319",
          "id": "Flight_01",
          "Identifier": {
           "authority": "Travelport",
           "value": "95fa78b6-da7d-4bcc-88f0-b76d39b82bcd"
          },
          "Departure": {
           "@type": "Departure",
           "location": "ORD",
           "date": "2025-06-28",
           "time": "07:00:00"
          },
          "Arrival": {
           "@type": "Arrival",
           "location": "DEN",
           "date": "2025-06-28",
           "time": "08:39:00"
          }
         }
        }
       ],
       "PassengerFlight": [
        {
         "@type": "PassengerFlight",
         "passengerQuantity": 1,
         "passengerTypeCode": "ADT",
         "FlightProduct": [
          {
           "@type": "FlightProduct",
           "segmentSequence": [
            1
           ],
           "classOfService": "Y",
           "cabin": "Economy",
           "fareBasisCode": "B0AIZNN1",
           "fareType": "PublicFare",
           "Brand": {
            "@type": "Brand",
            "name": "MAIN CABIN",
            "tier": 4,
            "id": "1752032"
           }
          }
         ]
        }
       ]
      }
     ],
     "Price": {
      "@type": "PriceDetail",
      "id": "PriceDetail_1",
      "CurrencyCode": {
       "value": "AUD"
      },
      "Base": 854,
      "TotalTaxes": 89.6,
      "TotalFees": 0,
      "TotalPrice": 943.6,
      "PriceBreakdown": [
       {
        "@type": "PriceBreakdownAir",
        "quantity": 1,
        "requestedPassengerType": "ADT",
        "Amount": {
         "@type": "Amount",
         "CurrencyCode": {
          "decimalPlace": 2,
          "value": "USD"
         },
         "Base": 514.59
        },
        "TravelerRefs": [
         "travelerRefId_1"
        ]
       },
       {
        "@type": "PriceBreakdownAir",
        "quantity": 1,
        "requestedPassengerType": "ADT",
        "Amount": {
         "@type": "Amount",
         "currencySource": "Charged",
         "approximateInd": true,
         "CurrencyCode": {
          "decimalPlace": 2,
          "value": "AUD"
         },
         "Base": 854,
         "Taxes": {
          "@type": "TaxesDetail",
          "TotalTaxes": 89.6,
          "Tax": [
           {
            "currencyCode": "AUD",
            "taxCode": "AY",
            "value": 9.3
           },
           {
            "currencyCode": "AUD",
            "taxCode": "US",
            "value": 64.1
           },
           {
            "currencyCode": "AUD",
            "taxCode": "XF",
            "value": 7.5
           },
           {
            "currencyCode": "AUD",
            "taxCode": "ZP",
            "value": 8.7
           }
          ]
         },
         "Total": 943.6
        },
        "FiledAmount": {
         "currencyCode": "USD",
         "decimalPlace": 2,
         "value": 514.59
        },
        "TravelerRefs": [
         "travelerRefId_1"
        ],
        "FareCalculation": "CHI AA DEN Q0.17 514.42B0AIZNN1 USD514.59END"
       }
      ]
     },
     "TermsAndConditionsFull": [
      {
       "@type": "TermsAndConditionsFullAir",
       "secureFlightPassengerDataRequiredInd": true,
       "Identifier": {
        "authority": "Travelport",
        "value": "e2a6584f-8593-43e2-a96a-aab11c526678"
       },
       "ExpiryDate": "2025-05-29T23:59:00Z",
       "BaggageAllowance": [
        {
         "@type": "BaggageAllowanceDetail",
         "passengerTypeCodes": [
          "ADT"
         ],
         "SegmentSequenceList": [
          1
         ],
         "Text": [
          "0PC"
         ]
        }
       ],
       "ValidatingAirline": [
        {
         "@type": "ValidatingAirline",
         "ValidatingAirline": "AA"
        }
       ],
       "TicketingAgency": [
        {
         "@type": "TicketingAgency",
         "Code": "XB7"
        }
       ],
       "PaymentTimeLimit": "2025-05-30T23:59:00Z",
       "PricingAgency": [
        {
         "@type": "PricingAgency",
         "Code": "XB7"
        }
       ],
       "FareGuaranteePolicy": [
        {
         "@type": "FareGuaranteePolicy",
         "passengerTypeCodes": [
          "ADT"
         ],
         "Code": {
          "value": "G"
         }
        }
       ]
      },
      {
       "@type": "TermsAndConditionsFullAir",
       "Restriction": [
        {
         "value": "NONREF/FAREDIF/"
        },
        {
         "value": "CXL BY FLT TIME OR NOVALUE"
        }
       ]
      }
     ]
    }
   ],
   "Traveler": [
    {
     "@type": "Traveler",
     "birthDate": "1986-11-11",
     "gender": "Male",
     "passengerTypeCode": "ADT",
     "id": "travelerRefId_1",
     "Identifier": {
      "authority": "Travelport",
      "value": "598e0e62-dfc9-424f-a250-25a136d2b786"
     },
     "PersonName": {
      "@type": "PersonName",
      "Given": "TESTFIRST",
      "Surname": "TESTLAST"
     },
     "Telephone": [
      {
       "@type": "TelephoneDetail",
       "countryAccessCode": "1",
       "phoneNumber": "212456121",
       "id": "telephone_1",
       "cityCode": "ORD",
       "role": "Home"
      }
     ],
     "Email": [
      {
       "emailType": "TO",
       "value": "TravelerOne@notmail.com"
      }
     ],
     "TravelDocument": [
      {
       "@type": "TravelDocumentDetail",
       "birthDate": "1986-11-11",
       "Gender": "Male",
       "PersonName": {
        "@type": "PersonName",
        "Given": "TESTFIRST",
        "Surname": "TESTLAST"
       }
      },
      {
       "@type": "TravelDocumentDetail",
       "docNumber": "A123123",
       "docType": "Passport",
       "expireDate": "2035-05-28",
       "issueCountry": "US",
       "birthDate": "1986-11-11",
       "Gender": "Male",
       "PersonName": {
        "@type": "PersonName",
        "Given": "TESTFIRST",
        "Surname": "TESTLAST"
       }
      }
     ]
    }
   ],
   "Receipt": [
    {
     "@type": "ReceiptConfirmation",
     "Identifier": {
      "authority": "Travelport",
      "value": "3bd5237e-25b7-4e8d-b8ea-f7a04f936f4b"
     },
     "Confirmation": {
      "@type": "ConfirmationHold",
      "Locator": {
       "source": "1G",
       "creationDate": "2025-05-28",
       "value": "BXPJVM"
      },
      "OfferStatus": {
       "@type": "OfferStatusAir",
       "StatusAir": [
        {
         "flightRefs": [
          "Flight_01"
         ],
         "code": "HK",
         "value": "Confirmed"
        }
       ]
      }
     }
    },
    {
     "@type": "ReceiptConfirmation",
     "Identifier": {
      "authority": "Travelport",
      "value": "dfa0a8de-2e33-4f88-aed7-7afc197e9d30"
     },
     "Confirmation": {
      "@type": "ConfirmationHold",
      "Locator": {
       "source": "AA",
       "value": "IUSHNW"
      }
     }
    }
   ],
   "ReservationDisplaySequence": {
    "@type": "ReservationDisplaySequence",
    "DisplaySequence": [
     {
      "@type": "DisplaySequence",
      "displaySequence": 1,
      "OfferRef": "offer_1",
      "ProductRef": "product_1",
      "Sequence": 1
     }
    ]
   }
  },
  "Identifier": {
   "authority": "Travelport",
   "value": "1546cc57-c5c3-4670-b555-fed35dd69ddf"
  }
 }
}