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

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

GET https://api.cacolombia.com/v1/banks/:bankId/accounts/:accountId/balance

Path Parameters

string

required

The Snowflake ID of the bank that holds the account.

string

required

The Snowflake ID of the account whose balance you want to retrieve.

Response

A successful response returns an object with a single field:

number

The account’s current balance in in-game currency units.

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.

Example Request

curl -X GET "https://api.cacolombia.com/v1/banks/112233445566778800/accounts/223344556677889900/balance" \
  -H "Authorization: Bearer <your_token>"

Example Response

{
  "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.

Overview

Auth & OAuth

Users

Characters

Economy

Banking

Staff

Utilities

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

Endpoint

Path Parameters

Response

Example Request

Example Response

Error Responses

​Endpoint

​Path Parameters

​Response

​Example Request

​Example Response

​Error Responses

Endpoint

Path Parameters

Response

Example Request

Example Response

Error Responses