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

# GET /v1/banks/:bankId/accounts/:accountId — Balance

> Retrieve only the current balance of a bank account without fetching the full account object. Requires account ownership or STAFF permission to access.

Use this endpoint to retrieve just the balance of a specific bank account without fetching the full account object. You can only check the balance of accounts owned by one of your own characters, or if your account holds the `STAFF` permission.

## Endpoint

```text theme={null}
GET https://api.cacolombia.com/v1/banks/:bankId/accounts/:accountId/balance
```

## Path Parameters

<ParamField path="bankId" type="string" required>
  The Snowflake ID of the bank that holds the account.
</ParamField>

<ParamField path="accountId" type="string" required>
  The Snowflake ID of the account whose balance you want to retrieve.
</ParamField>

## Response

A successful response returns an object with a single field:

<ResponseField name="balance" type="number">
  The account's current balance in in-game currency units.
</ResponseField>

<Note>
  This endpoint returns HTTP `201` on success (rather than `200`). This is a known behaviour of the current API version. Handle both `200` and `201` in your client to be safe.
</Note>

## Example Request

```bash theme={null}
curl -X GET "https://api.cacolombia.com/v1/banks/112233445566778800/accounts/223344556677889900/balance" \
  -H "Authorization: Bearer <your_token>"
```

## Example Response

```json theme={null}
{
  "balance": 45000
}
```

## Error Responses

| Status | Description                                                                          |
| ------ | ------------------------------------------------------------------------------------ |
| `401`  | You are not authenticated. Provide a valid authorization token with your request.    |
| `403`  | None of your characters own this account and you do not hold the `STAFF` permission. |
| `404`  | No bank was found for the given `bankId`.                                            |
| `404`  | No account was found for the given `accountId` within that bank.                     |