v1

latestOpenAPI 3.0.02026-07-247251950.2 KB
Manage bookings

Cancel a booking

Overview

Cancel an existing confirmed booking. Cancellation policies determine whether a full refund, partial refund, or charges apply.

When to Use

  • Guest cancellation - Allow guests to cancel their bookings
  • Administrative cancellation - Cancel bookings from admin panels
  • Policy enforcement - Apply cancellation policies automatically

What You Get

  • Cancellation status - Success or failure of cancellation
  • Charges information - Any fees or charges that apply
  • Refund details - Amount refunded (if applicable)
  • Updated booking status - Booking marked as cancelled

Cancellation Outcomes

  • CANCELLED - Fully refundable, no charges
  • CANCELLED_WITH_CHARGES - Non-refundable or past cancellation deadline, charges apply
  • Cancellation policies - Applied automatically based on booking terms

Important Notes

  • Non-refundable bookings - Will be cancelled but still charged (status: CANCELLED_WITH_CHARGES)
  • Policy enforcement - Cancellation policies are automatically applied
  • Past deadline - Cancellations after the policy deadline may incur charges

Quick Start

Provide the bookingId in the URL path. Returns cancellation status and any applicable charges or refunds.

put/bookings/{bookingId}

Path parameters

bookingIdstring required

Query parameters

timeoutnumber float

request timeout in seconds

Response

OK

sandboxboolean