> ## Documentation Index > Fetch the complete documentation index at: https://cal.id/docs/llms.txt > Use this file to discover all available pages before exploring further. # Cancel a booking > Cancel booking by id Optional request body field controls for cancellation scope, seated-event seat cancellation, and payment refund handling. ## OpenAPI ````yaml /openapi.json post /booking/{id}/cancel openapi: 3.1.0 info: title: Cal ID API description: >- API documentation for external developers integrating with Cal ID. This documentation is auto-generated from our OpenAPI specification and includes details on all available endpoints, request/response schemas, and authentication methods. Authentication is required for all endpoints and can be done using API key generated from the Cal ID dashboard under the `settings/developer/api-keys` page. Use the Authorization header with the Bearer scheme to authenticate your requests. Example: - API Key: `Authorization: Bearer calid_xxxxx` Note: To manage Team's resources use the Team's owner/admin API key version: 1.0.0 contact: name: API Support email: support@cal.id url: https://cal.id license: name: MIT url: https://opensource.org/licenses/MIT servers: - url: https://api.cal.id description: 'Production server ' security: - bearerAuth: [] tags: - name: Health description: Health check endpoints - name: Users description: User management endpoints - name: Event Types description: Event type management endpoints - name: Teams description: Team management endpoints - name: Team Event Types description: Event type management endpoints for teams - name: Team Memberships description: Membership management endpoints for teams - name: Team Schedules description: Schedule management endpoints for teams - name: Availability description: User availability management endpoints - name: Schedule description: User schedule management endpoints - name: Slots description: Available slots retrieval endpoints - name: Booking description: Event booking endpoints paths: /booking/{id}/cancel: post: tags: - Booking summary: Cancel a booking description: >- Cancel booking by id Optional request body field controls for cancellation scope, seated-event seat cancellation, and payment refund handling. operationId: cancel_booking parameters: - schema: type: integer exclusiveMinimum: 0 example: 101 minimum: 1 in: path name: id required: true description: Numeric booking identifier. requestBody: content: application/json: schema: type: object properties: allRemainingBookings: type: boolean description: >- When `true`, cancels all remaining future bookings in the recurring series from now onward. example: false cancellationReason: type: string default: Not Provided description: >- Optional reason stored on cancelled booking records and used in cancellation notifications. example: Rescheduling required seatReferenceUid: type: string description: >- Optional seat reference UID for cancelling a specific attendee seat in seated event types. example: seat_123 cancelledBy: type: string format: email description: >- Optional actor email recorded as the canceller (`cancelledBy`) on the booking. example: owner@example.com autoRefund: type: boolean default: false description: >- When `true`, attempts payment cancellation/refund for paid bookings and marks booking payment metadata as refunded. example: false additionalProperties: false description: >- Optional controls for cancellation scope, seated-event seat cancellation, and payment refund handling. example: cancellationReason: Rescheduling required description: >- Optional controls for cancellation scope, seated-event seat cancellation, and payment refund handling. responses: '200': description: Booking cancelled content: application/json: schema: type: object properties: success: type: boolean enum: - true data: type: object properties: success: type: boolean enum: - true message: type: string onlyRemovedAttendee: type: boolean bookingId: type: integer bookingUid: type: string required: - success - message - onlyRemovedAttendee - bookingId - bookingUid additionalProperties: false message: type: string meta: type: object properties: pagination: type: object properties: page: type: number limit: type: number total: type: number totalPages: type: number required: - page - limit - total - totalPages additionalProperties: false additionalProperties: {} required: - success additionalProperties: false description: Booking cancelled '400': description: Bad Request content: application/json: schema: type: object properties: success: type: boolean enum: - false message: type: string error: type: object properties: code: type: string message: type: string details: {} required: - code - message additionalProperties: false required: - success - message - error additionalProperties: false description: Bad Request '401': description: Unauthorized content: application/json: schema: type: object properties: success: type: boolean enum: - false message: type: string error: type: object properties: code: type: string message: type: string details: {} required: - code - message additionalProperties: false required: - success - message - error additionalProperties: false description: Unauthorized '404': description: Booking not found or invalid credentials content: application/json: schema: type: object properties: success: type: boolean enum: - false message: type: string error: type: object properties: code: type: string message: type: string details: {} required: - code - message additionalProperties: false required: - success - message - error additionalProperties: false description: Booking not found or invalid credentials security: - bearerAuth: [] components: securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT | API Key description: |- Use the Authorization header with Bearer scheme. Examples: - API Key: Authorization: Bearer calid_xxxxx ```` ## Related topics - [Reschedule and cancel bookings](/docs/developers/guides/reschedule-and-cancel.md) - [Mastering the Unified Calendar in Cal ID](/docs/getting-started/unified-calendar.md) - [Disable Rescheduling and Cancelling](/docs/event-types/advanced/disable-reschedule-cancel.md) - [Create a booking](/docs/developers/guides/create-a-booking.md) - [Monitoring Notification Delivery with Workflow Status](/docs/bookings/workflow-status.md)