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

# RiseID Balance

> Query on-chain USD balance for a team, user, or company RiseID

<Note>
  Requires `Authorization: Bearer <jwt>` — see [Authentication](/v1-legacy/authentication).
</Note>

## Get balance

**GET** `/v1/riseid/{rise_id}/balance`

<ParamField path="rise_id" type="string" required>
  Legacy numeric id, V1/V2 RiseID, RiseAccount address, or team/user/company nanoid — see [Identifier formats](/v1-legacy/overview#identifier-formats).
</ParamField>

<RequestExample>
  ```bash theme={null}
  curl -X GET "https://b2b-api.riseworks.io/v1/riseid/te-abc123def456/balance" \
    -H "Authorization: Bearer <jwt>"
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  {
    "data": "150000000"
  }
  ```
</ResponseExample>

The balance is returned as a raw decimal string in the token's smallest on-chain unit — the same raw format V1 returned. Convert using the token's decimals before displaying to users.

**SDK:**

```javascript theme={null}
const balance = await client.v1Legacy.getBalance('te-abc123def456');
```

## Errors

| Status | Cause                                                                                                                                        |
| ------ | -------------------------------------------------------------------------------------------------------------------------------------------- |
| `400`  | Invalid `rise_id` format, or no on-chain USD contract is configured for this environment (a server-side config issue, not a caller mistake). |
| `401`  | Missing or expired JWT.                                                                                                                      |
| `404`  | Entity or its RiseAccount not found.                                                                                                         |

Still stuck? See [Troubleshooting](/v1-legacy/troubleshooting).