Skip to main content
POST
Cancel a hotel booking and get a refund when eligible
Cancel a hotel booking when the traveler can no longer make the stay or wants to drop a hotel from a multi-item trip. The call is idempotent: retrying the same cancellation re-serves the stored result rather than charging or refunding twice. Works with guest auth (booking ref + last name) or the authenticated shortcut (provider booking ID). Two auth modes:
  • Guest: booking_ref + last_name together.
  • Authenticated: provider_booking_id (optionally with provider).
The two modes are mutually exclusive.

Authorizations

X-API-Key
string
header
required

Body

application/json
provider_booking_id
string
Example:

"NUITEE-88231"

provider
string
Example:

"nuitee"

booking_ref
string
Example:

"JNK-H1ZK90"

last_name
string
Example:

"Carrard"

intent
object

Response

Cancel a hotel booking and get a refund when eligible

provider_booking_id
string
Example:

"NUITEE-88231"

provider
string
Example:

"nuitee"

status
string
Example:

"cancelled"

refund_amount
object
penalty_amount
object
connector_reference
string
Example:

"cxl_2f90a1c3"

cancelled_at
string
Example:

"2026-06-01T12:34:56Z"

idempotent
boolean
Example:

false