> Parel documentation. Index of every page: https://parel.si/docs/llms.txt. This page in HTML: https://parel.si/docs/api/balance

# GET /v1/balance

> The team's prepaid balance in paise and as text, and where to get more credit.

```text
GET https://api.parel.si/v1/balance
```

Scope `read`. Free.

```bash
curl https://api.parel.si/v1/balance -H "Authorization: Bearer $PAREL_KEY"
```

## Response

| Field | Type | Description |
|---|---|---|
| `ok` | `true` | |
| `balance_paise` | integer | The balance now, in paise. Open holds have already been taken out of it. |
| `balance` | string | The same with the rupee sign and two decimals |
| `topup_url` | string | The dashboard's top-up page. During the closed beta it explains that credit is added by Parel; see [Top-ups](https://parel.si/docs/api/topups.md). |

Captured from staging:

```json
{
  "ok": true,
  "balance_paise": 9850,
  "balance": "₹98.50",
  "topup_url": "https://app.parel.si/topup"
}
```

Every paid response also carries the balance after the call as `balance_paise` and the `X-Balance-Paise` header, so a loop rarely needs to ask. Over MCP the same read is `check_balance`, which adds `how_to_get_credit`. [MCP reference](https://parel.si/docs/mcp.md#check_balance).
