Skip to main content

​
An account_id is used in API request URLs.

Use the Accounts API to fetch your own account_id and any managed accounts that you’ve created. You’ll need a bearer token from your client credentials first.
1

Authenticate and get a bearer token

Create client credentials in the Brale dashboard, then exchange them for a bearer token.
Response includes access_token and token_type (Bearer). Use Authorization: Bearer ${access_token} for subsequent calls.
2

List your accounts

Call GET /accounts with your bearer token to fetch account_ids:
Example response:
3

Select the right account_id for downstream calls

  • Use your primary account_id for operations on your own balances and resources.
  • If you manage client accounts (managed accounts), use the client’s account_id in path parameters for downstream endpoints (e.g., transfers, addresses).
  • Do not send account_id in the request body or querystring—only in the path where required.
If you only see one account_id returned, that’s your primary account. Managed client accounts will appear in the same list once created.