---
title: "Void a posted check end-to-end (ledger + payments + its gratuities) by its checkId"
method: DELETE
path: "/folio/v1/checks/{checkId}"
tags: ["Checks"]
---

# Void a posted check end-to-end (ledger + payments + its gratuities) by its checkId

`DELETE /folio/v1/checks/{checkId}`

## Request

- Base URL: `https://api.cloudbeds.com`
- URL: `https://api.cloudbeds.com/folio/v1/checks/{checkId}`
- Auth: OAuth 2
  - Authorization code: `https://api.cloudbeds.com/auth/oauth/authorize`
  - Token URL: `https://api.cloudbeds.com/auth/oauth/token` scopes: `write:item`

Voids the whole check: reverses each line (item / service charge / discount) and its tax/fee children on both CDC and DOMAIN, cascade-voids every gratuity linked to the check (each with its own tax children), and voids the anchored payments via the payments service. Idempotent — voiding an already-voided check returns 204.

## Path parameters

- `checkId` string, required

## Headers

- `x-property-id` string, required

## Response `204`

Check voided (or already voided — idempotent).

- unknown

## Other responses

- `403`: Forbidden — insufficient permissions on the requested property.
- `404`: Not found — no check matches the checkId on this property (CHECK_NOT_FOUND).
- `409`: Conflict — the check's folio target was never persisted (pre-feature posting) (CHECK_VOID_UNAVAILABLE).
- `500`: Internal server error — ledger void completed but one or more payment voids failed (PAYMENT_VOID_FAILED). Retry to converge.

---

[API](https://skmtc.dev/cloudbeds/apis/cloudbeds-api-v2.md) - [All operations](https://skmtc.dev/cloudbeds/apis/cloudbeds-api-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/cloudbeds/apis/cloudbeds-api-v2/revisions/69bffac143cc?raw)