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

# Get your account_id

> Fetch your account_id and managed account IDs using the Accounts API with a bearer token.

## 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.

<Steps>
  <Step title="Authenticate and get a bearer token">
    Create client credentials in the Brale dashboard, then exchange them for a bearer token.

    ```bash theme={null}
    curl --request POST \
      --url https://auth.brale.xyz/oauth2/token \
      --header 'Authorization: Basic ${BASE_64_OF(client_id:client_secret)}' \
      --header 'Content-Type: application/x-www-form-urlencoded' \
      --data grant_type=client_credentials
    ```

    Response includes `access_token` and `token_type` (Bearer). Use `Authorization: Bearer ${access_token}` for subsequent calls.
  </Step>

  <Step title="List your accounts">
    Call `GET /accounts` with your bearer token to fetch account\_ids:

    ```bash theme={null}
    curl --request GET \
      --url https://api.brale.xyz/accounts \
      --header "Authorization: Bearer ${ACCESS_TOKEN}"
    ```

    Example response:

    ```json theme={null}
    {
      "accounts": [
        "2Js1YFqlfxgNqC2KTPEjrWIwKU7",   // Your primary account_id
        "2VcUIIsgARwVbEGlIYbhg6fGG57"    // Managed client account_id (if applicable)
      ]
    }
    ```
  </Step>

  <Step title="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.
  </Step>
</Steps>

<Tip>
  If you only see one account\_id returned, that’s your primary account. Managed client accounts will appear in the same list once created.
</Tip>