> ## Documentation Index
> Fetch the complete documentation index at: https://docs.elumenta.ru/llms.txt
> Use this file to discover all available pages before exploring further.

# Token Balance

> Get the token balance of the authenticated user

## Request

```bash theme={null}
curl https://elumenta.ru/api/v2/balance \
  -H "Authorization: Bearer nb_YOUR_API_KEY"
```

## Response

```json theme={null}
{
  "token_balance": 283,
  "plan": "vip",
  "plan_expires_at": "2026-04-08T00:00:00Z"
}
```

<ResponseField name="token_balance" type="integer">
  Current balance — subscription tokens + any purchased token packages combined.
</ResponseField>

<ResponseField name="plan" type="string">
  Active plan: `free` (Starter) | `basic` | `pro` | `vip` | `elite`
</ResponseField>

<ResponseField name="plan_expires_at" type="string | null">
  ISO 8601 expiry date of the subscription. `null` for Starter plan.
</ResponseField>

<Tip>
  The full user profile including `token_limit` and rate limits is available via [GET /api/v2/user/me](/en/api-reference/user/me).
</Tip>