Skip to main content
POST
/
v1
/
hotel_cancel
Cancel a hotel booking and get a refund when eligible
curl --request POST \
  --url https://api.example.com/v1/hotel_cancel \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "provider_booking_id": "NUITEE-88231",
  "provider": "nuitee",
  "booking_ref": "JNK-H1ZK90",
  "last_name": "Carrard"
}
'
{
  "provider_booking_id": "NUITEE-88231",
  "provider": "nuitee",
  "status": "cancelled",
  "refund_amount": {
    "value": 318.4,
    "amount": 123,
    "currency": "USD",
    "decimal_places": 2
  },
  "penalty_amount": {
    "value": 318.4,
    "amount": 123,
    "currency": "USD",
    "decimal_places": 2
  },
  "connector_reference": "cxl_2f90a1c3",
  "cancelled_at": "2026-06-01T12:34:56.000Z",
  "idempotent": false
}
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"

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:56.000Z"

​
idempotent
boolean
Example:

false