Cancel Hotel Reservation API Reference
Put |
book/reservations/{AggregatorLocatorCode}/canceloffer?supplierLocator={SupplierLocatorCode} 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.
Use this base path if you have not yet received or not migrated to the new credentials from Travelport:
Use this base path after you have migrated to the new credentials from Travelport (using .net instead of .com):
|
Related Content: JSON Hotel APIs Guide, Hotel Reservation Retrieve API Reference
The Cancel Hotel Reservation API cancels an existing hotel reservation.
Request
Query Parameters
Parameter | Description | Required/Optional |
---|---|---|
SupplierLocatorCode |
Send the supplier locator code returned at booking or in Reservation Retrieve in Receipt/Confirmation/Locator/value. Hotel bookings return multiple locator codes. For the supplier locator code, send the value from the instance of Receipt with Confirmation/Locator/locatorType=Confirmation Number and sourceContext=Supplier. See Locator Codes for details.
|
Required |
Request Body
This API does not send a request payload.
Example Request
This API does not send a request payload.
Response
The Reservation Cancel response returns the same type of data using the same structure as the Create Reservation response. See the Create Reservation Reference Payload API Reference for documentation.
See the example below for all differences in data for a canceled reservation versus an active reservation.
Example Response
The Reservation Cancel response returns the same type of data using the same structure as the Create Reservation response. Using the same structure, the differences for a canceled reservation are as follows:
-
In the instance of Receipt for the supplier, Confirmation/Locator/value returns the supplier cancellation number, and locatorType is Cancellation Number.
-
Also in the instance of Receipt for the supplier, OfferStatus/code is HK and Status is Cancelled.
-
In the instances of Receipt for both the supplier and Travelport, Confirmation/Locator/creationDate returns the date the reservation was canceled instead of the date it was created.
Note that for readability all objects except Receipt were truncated [...]. All truncated objects return the same reservation data from the original booking as would a Reservation Retrieve.

{"ReservationResponse": {
"Reservation": {
"@type": "ReservationDetail",
"Offer": [
{...}
],
"Traveler": [...],
"TravelerProduct": [...],
"FormOfPayment": [...],
"Payment": [...],
"Receipt": [
{
"@type": "ReceiptConfirmation",
"OfferRef": [
"O1"
],
"Confirmation": {
"@type": "ConfirmationHold",
"Locator": {
"value": "59824913",
"locatorType": "Cancellation Number",
"source": "TX",
"sourceContext": "Supplier",
"creationDate": "2025-10-01"
},
"OfferStatus": {
"@type": "OfferStatusHospitality",
"code": "HK",
"Status": "Cancelled"
}
}
},
{
"@type": "ReceiptConfirmation",
"Confirmation": {
"@type": "ConfirmationHold",
"Locator": {
"value": "D6YPS5",
"locatorType": "PNR Locator",
"sourceContext": "Travelport",
"creationDate": "2025-10-01"
},
"OfferStatus": {
"@type": "OfferStatusHospitality",
"Status": "Confirmed"
}
}
}
],
},
"traceId": "84d1c6ba-6fec-44c3-9331-a9d6de67719a"
}
}