---
title: "Request cancellation of a channel reservation"
method: POST
path: "/reservations-v3/{reservationId}/request-cancellation"
tags: ["Reservations Open Api [Beta]"]
---

# Request cancellation of a channel reservation

`POST /reservations-v3/{reservationId}/request-cancellation`

Request cancellation of a channel reservation with a reason and message to the guest and channel. The reservation must be from a channel and in 'confirmed' status to be cancelled.

## Path parameters

- `reservationId` string, required

## Request body

- object
  - `reason` 'DECLINE_REASON_HOST_DOUBLE' | 'DECLINE_REASON_HOST_CHANGE' | 'DECLINE_REASON_HOST_UNAUTHORIZED_PARTY' | 'DECLINE_REASON_HOST_BEHAVIOR' | 'DECLINE_REASON_HOST_OTHER' | 'DECLINE_REASON_HOST_ASKED' | 'DECLINE_REASON_COVID19_HOST' | 'DECLINE_REASON_HOST_BAD_FIT' | 'DECLINE_REASON_HOST_BAD_REVIEWS_SPARSE_PROFILE', required — The primary reason for cancelling the reservation. This is required by the channel to process the cancellation
  - `subReason` 'DECLINE_REASON_HOST_EMERGENCY' | 'DECLINE_REASON_HOST_HOST_UNAVAILABLE' | 'DECLINE_REASON_HOST_DOUBLE_BOOKED' | 'DECLINE_REASON_HOST_RESERVATION_LENGTH' | 'DECLINE_REASON_HOST_DIFFERENT_PRICE' | 'DECLINE_REASON_HOST_UNAUTHORIZED_PARTY' | 'DECLINE_REASON_HOST_PARTY_REVIEWS' | 'DECLINE_REASON_HOST_PARTY_INDICATION' | 'DECLINE_REASON_HOST_BEHAVIOR_REVIEWS' | 'DECLINE_REASON_HOST_BEHAVIOR_INDICATION' | 'DECLINE_REASON_HOST_BEHAVIOR_OTHER' | 'DECLINE_REASON_HOST_GUEST_PROFILE', required — The specific sub-reason that provides more detail about the cancellation. This helps the channel understand the context better
  - `messageToChannel` string, required — Message to be sent to the channel explaining the cancellation
  - `messageToGuest` string, required — Message to be sent to the guest explaining the cancellation. This will be communicated to the guest through the channel

## Response `200`

Cancellation request created successfully

## Other responses

- `201`
- `404` — Returned if the reservation is not found
- `422` — Returned if the reservation is not in a valid status for cancellation or if required fields are missing
- `500` — Indicates server-side error while processing the request

---

[API](https://skmtc.net/guesty/apis/guesty-open-api.md) · [All operations](https://skmtc.net/guesty/apis/guesty-open-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/guesty/guesty-open-api/versions/7c62644070f2/schema)