> ## Documentation Index > Fetch the complete documentation index at: https://api-docs.nowbookit.com/llms.txt > Use this file to discover all available pages before exploring further. # Cancel a Reservation > Cancel a reservation and release its table. Cancels a reservation and releases its table, so the slot becomes bookable again. ## OpenAPI ````yaml platform/reservation/openapi.json POST /venue/{venueId}/reservation/{id}/cancel openapi: 3.0.4 info: title: NowBookIt Reservation API description: >- REST API for venue availability and reservation lifecycle. Every endpoint is venue-scoped: `/api/reservations/venue/{venueId}/...`. version: v1 contact: email: platform.integrations@nowbookit.com servers: - url: https://platform.uat.nowbookit.com/api/reservations description: UAT - url: https://platform.nowbookit.com/api/reservations description: Production security: - ApiKeyAuth: [] tags: - name: Availability description: What a venue can offer for a party size over a date range. - name: Reservations description: List, read, create, amend and cancel a venue's reservations. - name: Reference data description: A venue's own guest tags and reservation statuses. paths: /venue/{venueId}/reservation/{id}/cancel: post: tags: - Reservations summary: Cancel a reservation description: >- Cancels a reservation and releases its table. The reservation is not deleted — it keeps its place with a cancelled status and still appears in the venue's diary. **There is no request body.** The reservation is named in the path, and a cancellation reason is not accepted. Cancellation emails and SMS are not sent yet — send your own guest correspondence in the meantime. operationId: cancelReservation parameters: - $ref: '#/components/parameters/VenueId' - $ref: '#/components/parameters/ReservationId' responses: '200': description: Cancelled. The body is the reservation id and its resulting status. content: application/json: schema: $ref: '#/components/schemas/CancelledReservation' example: id: booking_2026-09-01_G3F7PA8HO438Z_1787294227662 status: X '400': $ref: '#/components/responses/ValidationFailed' '404': description: No such reservation at this venue, or no such venue. content: application/json: schema: oneOf: - $ref: '#/components/schemas/DetailResponse' - $ref: '#/components/schemas/ErrorResponse' example: detail: >- Reservation not found: booking_2026-09-01_G3F7PA8HO438Z_1787294227662 '409': description: >- Already cancelled, already started, or a concurrent change. `detail` says which. content: application/json: schema: $ref: '#/components/schemas/DetailResponse' example: detail: This reservation is already cancelled '500': $ref: '#/components/responses/ServerError' '501': description: >- The reservation involves a payment — a deposit, full payment or pre-auth. content: application/json: schema: $ref: '#/components/schemas/DetailResponse' example: detail: >- Cancelling a reservation that involves payment is not implemented yet components: parameters: VenueId: name: venueId in: path required: true description: The venue being addressed. Every endpoint on this API is venue-scoped. schema: type: string minLength: 1 example: '6247' ReservationId: name: id in: path required: true description: The reservation's `id` — not its `bookingRef`. schema: type: string minLength: 1 example: booking_2026-08-24_G3F7PA8HO438Z_1787294227662 schemas: CancelledReservation: type: object description: >- What a cancellation returns: the reservation it cancelled and the status that reservation now holds — not the whole reservation. `GET` the reservation if you need the full record; the tables, options and payment on a cancelled reservation are the ones it *had*, not what it still holds. required: - id properties: id: type: string description: >- The reservation that was cancelled — the same id you sent in the path. example: booking_2026-09-01_G3F7PA8HO438Z_1787294227662 status: allOf: - $ref: '#/components/schemas/ReservationStatusCode' description: The venue's cancelled status code — in practice `X`. DetailResponse: type: object description: >- The shape returned by the reservation write outcomes that are not validation failures — `409` and `501` on create, and `404` / `409` / `501` on update and cancel. required: - detail properties: detail: type: string ErrorResponse: type: object required: - code - message - requestId properties: code: type: string description: >- The error class, e.g. `ValidationError`, `NotFoundError`, `InternalError`. example: NotFoundError message: type: string requestId: type: string description: Quote this when reporting a problem. ReservationStatusCode: type: string enum: - U - P$ - C - X - NS - S - F - SP - TX description: >- The status code the reservation carries, joining onto the reservation-statuses endpoint's `code`. `U` unconfirmed, `P$` pending payment, `C` confirmed, `X` cancelled, `NS` cancelled no-show, `S` seated, `F` finished, `SP` standby pending, `TX` SMS sent or SMS failed. Several statuses can share one code, so treat `code` as a coarse grouping and `statusId` as the precise value. Venues can add statuses of their own, so read the venue's own set from the reservation-statuses endpoint rather than assuming this list is closed. ValidationErrorResponse: allOf: - $ref: '#/components/schemas/ErrorResponse' - type: object required: - errors properties: errors: type: object description: >- Field path to the messages for that field. A cross-field rule with no single field to blame is keyed `query`, `path` or `body`. additionalProperties: type: array items: type: string responses: ValidationFailed: description: >- The request failed validation. `errors` is keyed by field path — `query`, `path` or `body` for an issue with no single field to blame. content: application/json: schema: $ref: '#/components/schemas/ValidationErrorResponse' example: code: ValidationError message: Query parameters failed validation requestId: 0f1c9f2e-4b8a-4c1e-9d33-2a7f5b1c8e90 errors: partySize: - partySize must be at least 1 endDate: - endDate must be on or after startDate ServerError: description: An unexpected failure. Quote `requestId` when reporting one. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: code: InternalError message: Internal server error requestId: 0f1c9f2e-4b8a-4c1e-9d33-2a7f5b1c8e90 securitySchemes: ApiKeyAuth: type: http scheme: bearer description: >- Your API key. See [Authorization](/platform/authorization) to create one. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.