> 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-operator-info.md).

# /v1/operator/info

## Get Operator Information

<mark style="color:yellow;">`GET`</mark> `/v1/operator/info`

Returns detailed information about the authenticated operator, including name, RTP, balance, and callback URL. This endpoint requires valid authentication.

**Headers**

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

**Parameters**

No parameters

**Response**

```json
{
  "success": true,
  "message": "OK",
  "data": {
    "id": "operator_id_1",
    "name": "scorpioplay",
    "parentId": "parent_operator_1",
    "balance": [
      {
        "currency": "USD",
        "amount": 5000
      }
    ],
    "rtp": 95,
    "callbackURL": "https://example.com/api/callback",
    "allowedIPs": [
      "1.1.1.1"
    ],
    "providers": [
      1, 2
    ],
    "ggrRate": 4,
    "level": "agent",
    "paymentMethod": "deposit"
  }
}
```

#### Root Response Object

<table><thead><tr><th width="137">Field</th><th width="114">Data Type</th><th>Description</th></tr></thead><tbody><tr><td>success</td><td>boolean</td><td>Indicates whether the request was successfully processed</td></tr><tr><td>message</td><td>string</td><td>Human-readable response message</td></tr><tr><td>data</td><td>object</td><td>Operator information payload</td></tr></tbody></table>

***

#### `data` Object – Operator Information

<table><thead><tr><th width="152">Field</th><th width="194">Data Type</th><th>Description</th></tr></thead><tbody><tr><td>id</td><td>string</td><td>Unique operator identifier generated by Scorpio Play</td></tr><tr><td>name</td><td>string</td><td>Operator's company name or individual name</td></tr><tr><td>parentId</td><td>string</td><td>Parent operator's identifier</td></tr><tr><td>balance</td><td>array&#x3C;BalanceObject></td><td>List of wallet balances grouped by currency</td></tr><tr><td>rtp</td><td>number</td><td>Default Return To Player (RTP) percentage applied to the operator</td></tr><tr><td>callbackURL</td><td>string</td><td>Callback endpoint used for wallet, transaction, or game event notifications</td></tr><tr><td>allowedIPs</td><td>array&#x3C;string></td><td>Whitelisted IP addresses allowed to access the API</td></tr><tr><td>providers</td><td>array&#x3C;number></td><td>List of enabled game provider IDs for the operator</td></tr><tr><td>ggrRate</td><td>number</td><td>Gross Gaming Revenue (GGR) rate percentage applied to the operator</td></tr><tr><td>level</td><td>string</td><td>Operator hierarchy level (e.g. <code>operator</code>, <code>agent</code>)</td></tr><tr><td>paymentMethod</td><td>string</td><td>Wallet settlement method (e.g. <code>deposit</code>, <code>invoice</code>)</td></tr></tbody></table>

***

#### `balance` Object

<table><thead><tr><th width="125">Field</th><th width="118">Data Type</th><th>Description</th></tr></thead><tbody><tr><td>currency</td><td>string</td><td>Currency code (ISO 4217 format, e.g. <code>USD</code>, <code>EUR</code>)</td></tr><tr><td>amount</td><td>number</td><td>Available balance amount for the specified currency</td></tr></tbody></table>