> For the complete documentation index, see [llms.txt](https://docs.thndr.io/integration/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.thndr.io/integration/server-webhooks/balance.md).

# Balance

This method is called by THNDR to initialise or refresh the balance of a player in a game.

#### Endpoint

```url
GET {operatorURL}/thndr/users/{userId}/balance
```

#### Path Parameters

* `operatorURL` - Base URL of the Operator’s API.
* `userId` -  Player identifier on the Operator’s platform.

#### Query Parameters

* `sessionId` - The session ID provided by the operator during user authentication.
* `currency` - Player's wallet currency (read more in [Currencies](/integration/server-webhooks/currencies.md)).

#### Expected Response

```json
{
    "balance": 12050
}
```

* `balance` - Balance in the smallest unit of the currency (e.g., cents for USD, pence for GBP)

#### Signature Verification

Verify the request signature using userId as the request payload. More in the [Request Signing](/integration/server-webhooks/request-signing.md) section.
