---
title: "Cancel a booking (mandatory when plans change — no-shows are tracked)"
method: POST
path: "/v1/bookings/{booking_id}/cancel"
---

# Cancel a booking (mandatory when plans change — no-shows are tracked)

`POST /v1/bookings/{booking_id}/cancel`

## Request

- Base URL: `https://mercantry.org`
- URL: `https://mercantry.org/v1/bookings/{booking_id}/cancel`
- Auth: none declared

## Path parameters

- `booking_id` string, uuid, required

## Request body

- object
  - `reason` string

## Response `200`

Cancelled.

## Other responses

- `400`: booking_in_terminal_state — already failed/cancelled.
- `404`: unknown_booking.

---

[API](https://skmtc.dev/mercantry/apis/registry-agent-native-merchant-registry-rest-mirror.md) · [All operations](https://skmtc.dev/mercantry/apis/registry-agent-native-merchant-registry-rest-mirror/llms.txt) · [OpenAPI document](https://skmtc.dev/mercantry/apis/registry-agent-native-merchant-registry-rest-mirror/revisions/0a9bf614fe96?raw)