RiseID Balance

curl -X GET "https://b2b-api.riseworks.io/v1/riseid/te-abc123def456/balance" \
  -H "Authorization: Bearer <jwt>"

{
  "data": "150000000"
}

Requires Authorization: Bearer <jwt> — see Authentication.

Get balance

GET /v1/riseid/{rise_id}/balance

string

required

Legacy numeric id, V1/V2 RiseID, RiseAccount address, or team/user/company nanoid — see Identifier formats.

curl -X GET "https://b2b-api.riseworks.io/v1/riseid/te-abc123def456/balance" \
  -H "Authorization: Bearer <jwt>"

{
  "data": "150000000"
}

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:

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.

⌘I

Getting Started

Endpoints

Help

Get balance

Errors

​Get balance

​Errors

Get balance

Errors