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

# /v1/player/info

## Retrieve player account information

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

Fetches detailed information about a player based on a unique identifier such as `userId` in operator side. Typically used to validate session ownership or display player details before launching a game.

**Headers**

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

**Parameters**

```json
{
  "playerExternalId": "playerId_onOperatorSide"
}
```

<table><thead><tr><th width="173">Key</th><th width="132">Data Type</th><th width="326">Description</th><th>Mandatory</th></tr></thead><tbody><tr><td>playerExternalId</td><td>string</td><td>Unique player identifier from the operator’s system used to link or identify the player in the API</td><td>Required</td></tr></tbody></table>

**Response**

```json
{
  "success": true,
  "message": "OK",
  "data": {
    "playerCode": 100000121,
    "balance": [
      {
        "currency": "USD",
        "amount": 5000
      }
    ]
  }
}
```

<table><thead><tr><th width="221">Key</th><th width="124">Data Type</th><th>Description</th></tr></thead><tbody><tr><td>success</td><td>boolean</td><td>Indicates whether the request was processed successfully</td></tr><tr><td>message</td><td>string</td><td>Human-readable status message</td></tr><tr><td>data</td><td>object</td><td>Container for the response payload</td></tr><tr><td>data.playerCode</td><td>number</td><td>Unique internal player identifier assigned by the system</td></tr><tr><td>data.balance</td><td>array</td><td>List of player wallet balances by currency</td></tr><tr><td>data.balance[].currency</td><td>string</td><td>Currency code (e.g., USD, EUR)</td></tr><tr><td>data.balance[].amount</td><td>number</td><td>Available balance amount for the specified currency</td></tr></tbody></table>