---
title: "Preview a cancellation"
method: GET
path: "/v1/bookings/{booking_id}/cancellation_preview"
tags: ["Bookings"]
---

# Preview a cancellation

`GET /v1/bookings/{booking_id}/cancellation_preview`

## Request

- Base URL: `https://threshold.rentals/api`
- URL: `https://threshold.rentals/api/v1/bookings/{booking_id}/cancellation_preview`
- Auth: HTTP bearer

What the guest would get back if they cancelled now. Changes nothing. Tell the guest the refund and get their go-ahead before cancelBooking.

## Path parameters

- `booking_id` string, required

## Response `200`

The refund if cancelled now

- CancellationPreview
  - `booking_id` string
  - `status` string
  - `cancellable` boolean
  - `refund` Money
    - `amount` integer, required: In cents
    - `currency` string, required
  - `retained` Money
    - `amount` integer, required: In cents
    - `currency` string, required
  - `tier_ends_at` string, date-time, nullable
  - `as_of` string, date-time
  - `note` string

## Other responses

- `401`: Agent token missing (unauthorized)
- `404`: Not found (property_not_found, quote_not_found, booking_not_found)
- `429`: Rate limited or too many open requests: see Retry-After

---

[API](https://skmtc.dev/threshold/apis/threshold-stays-api.md) · [All operations](https://skmtc.dev/threshold/apis/threshold-stays-api/llms.txt) · [OpenAPI document](https://skmtc.dev/threshold/apis/threshold-stays-api/revisions/7acf3ae91b56?raw)