> 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-detail-issueid.md).

# /v1/bonus-call/detail/:issueId

## Get bonus call detail by issue ID

<mark style="color:$warning;">`GET`</mark> `/v1/bonus-call/detail/:issueId`

Retrieves detailed information about a specific bonus call using its unique `issueId`. This can include spin status, result, reward, and metadata such as timestamps or usage context.

**Headers**

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

**Query Parameters**

<table><thead><tr><th width="139">Field</th><th width="129">Data Type</th><th width="336">Meaning</th><th>Mandatory</th></tr></thead><tbody><tr><td>issueId</td><td>string</td><td>ID of the bonus call issued by our API</td><td>Required</td></tr></tbody></table>

**Response**

```json
{
  "success": true,
  "message": "OK",
  "data": {
    "issueId": "i3746",
    "operatorId": "democasino",
    "providerId": 1,
    "gameCode": "vswaysdog",
    "playerExternalId": "playerId_onOperatorSide",
    "currency": "USD",
    "bonusType": 1,
    "callAmount": 100,
    "metaData": {
      "spinAmount": 100,
      "playedAmount": 50,
      "betLevel": 1,
      "expireAt": "2025-10-08T14:00:00.000Z",
      "maxWinAmount": 1500
    },
    "status": 1,
    "totalWinAmount": 500,
    "createdAt": "2025-10-08 14:00:00"
  }
}
```

<table><thead><tr><th width="279">Field</th><th width="115">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><tr><td>data.issueId</td><td>string</td><td>Unique ID for the bonus issue</td></tr><tr><td>data.operatorId</td><td>string</td><td>ID of the operator</td></tr><tr><td>data.providerId</td><td>number</td><td>Game provider ID</td></tr><tr><td>data.gameCode</td><td>string</td><td>Internal game code of the title</td></tr><tr><td>data.playerExternalId</td><td>string</td><td>Player’s unique ID on the operator side</td></tr><tr><td>data.currency</td><td>string</td><td>Currency code (e.g., USD)</td></tr><tr><td>data.bonusType</td><td>number</td><td>Type of bonus (e.g., 1 = free spin)</td></tr><tr><td>data.callAmount</td><td>number</td><td>Amount related to the bonus call</td></tr><tr><td>data.metaData.spinAmount</td><td>number</td><td>Amount bet per spin</td></tr><tr><td>data.metaData.playedAmount</td><td>number</td><td>Amount already played from this bonus</td></tr><tr><td>data.metaData.betLevel</td><td>number</td><td>Bet level</td></tr><tr><td>data.metaData.expireAt</td><td>string</td><td>Expiration timestamp for the bonus (<code>ISO 8601</code>)</td></tr><tr><td>data.metaData.maxWinAmount</td><td>number</td><td>Maximum allowed win amount</td></tr><tr><td>data.status</td><td>number</td><td>Status of the bonus (1 = active, 2 = completed, etc.)</td></tr><tr><td>data.totalWinAmount</td><td>number</td><td>Total accumulated win from this bonus</td></tr><tr><td>data.createdAt</td><td>string</td><td>Timestamp when the bonus issue was created (YYYY-MM-DD HH:mm:ss)</td></tr></tbody></table>