> ## Documentation Index
> Fetch the complete documentation index at: https://developers.1-funnel.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Retrieve wallet balance

> Read current, available, and reserved balances.

<Warning>
  **Developer Preview**

  This documentation describes the upcoming 1Funnel External Integration API.

  The documented API endpoints and authentication services are not yet available
  for public integration.

  You can explore the API specifications, request and response schemas, webhook
  events, and integration guides.

  Sandbox and production availability will be announced separately.
</Warning>

`GET /v1/businesses/{businessId}/wallet/balance`

Required permission: `wallet.balance.read`.

```bash theme={null}
curl "https://api.sandbox.1-funnel.org/v1/businesses/{businessId}/wallet/balance" \
  -H "Authorization: Bearer $ACCESS_TOKEN"
```

```python theme={null}
# Illustrative Python example
import requests
r = requests.get(
    f"{base}/v1/businesses/{business_id}/wallet/balance",
    headers={"Authorization": f"Bearer {token}"},
    timeout=30,
)
```

Balances use decimal strings and an ISO currency code. `as_of` is the balance
timestamp. Fields include current, available, and reserved balances as defined
in OpenAPI.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.