---
title: "Release a hotel reservation"
method: POST
path: "/api/v1/hotels/cancel"
tags: ["Hotels"]
---

# Release a hotel reservation

`POST /api/v1/hotels/cancel`

Free until `balance_due_by`; after that the hotel's own cancellation ladder applies and can
reach 100%. That ladder ships in the booking's `terms`, so the cost is knowable first.

The 5% reservation fee is NOT refunded.

Drives a browser at the supplier and takes over a minute. If it times out, do not assume it
failed — re-check before retrying.

## Request body

- object
  - `confirmation` string, required

## Response `200`

Cancelled, with any charge applied

## Other responses

- `402` — No payment method on file

## Changes

- **2026-08-04** `7bda5c981b41` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/letsfg/apis/letsfg-api/changes/api/v1/hotels/cancel/post.md)

---

[API](https://skmtc.dev/letsfg/apis/letsfg-api.md) · [All operations](https://skmtc.dev/letsfg/apis/letsfg-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/letsfg/letsfg-api/revisions/89a6a1405650/schema)