Hotels API

Cancellation fee

Get the penalty a booked hotel would cost if you cancelled it today. It is a read-only quote. It cancels nothing and refunds nothing.

GET/booking/{bookingReference}/accommodations/{accommodationBookingReference}/cancellation-fee

A read-only quoteDocs

The response is what cancelling today would cost. Nothing changes on the booking. The spec describes this operation as "refund the amount of the penalty", which is wrong: it neither cancels nor refunds. Follow the docs, which describe it as recovering the cancellation fee on the day.

Request

Headers

auth-tokenstringrequired
Any valid token.
Accept-EncodingstringrequiredDocs
gzip

Path

bookingReferencestringrequired
Trip reference from the Book response, for example TST-1464.
accommodationBookingReferencestringrequiredTested
Service reference from the Book response (accommodation.bookingReference), for example TST-1464-0. The supplier's reference (hotelservice[].bookingReference in getBookings) is accepted too.

Response

200 OK

cancellationFeeMoneyVOSpec

The penalty if you cancel today.

Child attributes
amountnumber
The fee. 0 means cancelling today is free.
currencystring
ISO 4217 code, for example EUR.
auditDataAuditResponseVO
Includes traceId (one per token: log it) and authToken (redact it before logging).

How to use it

  • Call it right before you cancel, not when the booking is made. The answer is for today, and the penalty steps up as the dates in the booking's cancellationPolicies[] pass.
  • Show the amount to the guest and get consent. Then call Cancel once.
  • Use it to work out the refund: what the guest paid minus this fee. See Refund.

Show deadlines carefully

The fee endpoint gives you an amount, not a deadline. When you also show "free cancellation until" dates:

  • Take the date from the booking-level cancellationPolicies[] in getBookings. It is in operator local time and matches what agents see in the back office. The service-level hotelservice[].cancelPolicy[] date is in UTC and can be a day off near midnight. Verified
  • Suppliers apply deadlines in hotel local time, so word them conservatively: "free cancellation before <date>".

Errors

The spec documents no error schema and no status codes. Treat any non-2xx response as a failure and keep the raw body and the trace id. Spec A 404 means the reference doesn't exist (in this microsite). Verified This call changes nothing, so it is safe to retry after a 5xx, 429 or timeout.

Cancel

Cancel a booked hotel at the supplier. The response returns the booking with status CANCELED. Cancel is not safely retryable, and it does not refund the guest.

Get booking

Read a whole trip, every service type included, by microsite and booking reference. This is the call to make after a webhook, and the source of truth for back-office and accounting syncs.