---
title: "Decline a channel reservation"
method: POST
path: "/reservations-v3/{reservationId}/decline"
tags: ["Reservations Open Api [Beta]"]
---

# Decline a channel reservation

`POST /reservations-v3/{reservationId}/decline`

Decline a channel reservation that is in 'reserved' status with a reason and message to the guest. This endpoint creates a decline request that will be processed asynchronously. The reservation must be from a channel (like Airbnb, Booking.com, etc.) and in 'reserved' status to be declined.

## Path parameters

- `reservationId` string, required

## Request body

- object
  - `reason` string — The reason for declining the reservation
  - `messageToGuest` string — Message to be sent to the guest

## Response `200`

Decline request created successfully

## Other responses

- `201`
- `400` — Returned if the reservation is not in a valid status for decline or if required fields are missing
- `422` — Returned if there is a validation error in the request body
- `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)