> For the complete documentation index, see [llms.txt](https://scorpioplay.gitbook.io/scorpio-play-casino-api-doc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://scorpioplay.gitbook.io/scorpio-play-casino-api-doc/api-reference/openapi/v1-bonus-call-cancel.md).

# /v1/bonus-call/cancel

## Cancel or revoke a bonus call

<mark style="color:$success;">`POST`</mark> `/v1/bonus-call/cancel`

Cancels an active or reserved bonus call session. This is typically used in error recovery, fraud prevention, or rollback scenarios. The request must include the unique spin ID or user-bonus context.

**Headers**

| Name          | Value                |
| ------------- | -------------------- |
| Authorization | `Bearer <API_TOKEN>` |
| Content-Type  | `application/json`   |
| Accept        | `application/json`   |

**Request Body**

<table><thead><tr><th width="133">Field</th><th width="135">Data Type</th><th width="366">Meaning</th><th>Mandatory</th></tr></thead><tbody><tr><td>issueId</td><td>string</td><td>Unique ID for the issued bonus event.</td><td>Required</td></tr></tbody></table>

**Response**

```json
{
  "success": true,
  "message": "OK"
}
```

<table><thead><tr><th width="118">Field</th><th width="117">Data Type</th><th>Meaning</th></tr></thead><tbody><tr><td>success</td><td>boolean</td><td>Indicates whether the API call succeeded</td></tr><tr><td>message</td><td>string</td><td>Textual confirmation of the API call</td></tr></tbody></table>