---
title: "Cancel a booking"
method: PUT
path: "/bookings/{bookingId}"
tags: ["Manage bookings"]
---

# Cancel a booking

`PUT /bookings/{bookingId}`

## 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.

## Path parameters

- `bookingId` string, required

## Query parameters

- `timeout` number, float

## Response `200`

OK

- object
  - `data` object
    - `bookingId` string, required
    - `status` string, required
    - `cancellation_fee` number
    - `refund_amount` number
    - `currency` string, required
  - `sandbox` boolean

## Other responses

- `204` — No Content
- `304` — Not Modified
- `401` — Unauthorized

---

[API](https://skmtc.net/liteapi/apis/api-search.md) · [All operations](https://skmtc.net/liteapi/apis/api-search/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/liteapi/api-search/versions/315ba2a4dcf4/schema)