GET /v1/banks/:bankId/accounts — List Bank Accounts

Use this endpoint to retrieve all accounts that belong to a specific bank. Each account object includes the account ID, the character it belongs to, and the current balance. Only the bank owner and users with the STAFF permission can access this list.

This endpoint returns every account in the bank in a single response. To view bank accounts belonging to a specific character, use the character bank accounts endpoint instead.

Endpoint

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

Path Parameters

string

required

The Snowflake ID of the bank whose accounts you want to list.

Response

A successful 200 response returns an object containing an array of account objects:

array

An array of account objects belonging to the bank. Returns an empty array if the bank has no accounts.

Show Account object fields

string

The unique Snowflake ID for this bank account.

string

The Snowflake ID of the bank this account belongs to.

string

The characterId of the character who owns this account.

number

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

string

ISO 8601 timestamp of when the account was opened.

string

ISO 8601 timestamp of when the account was last modified.

Example Request

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

Example Response

{
  "accounts": [
    {
      "accountId": "223344556677889900",
      "bankId": "112233445566778800",
      "characterId": "998877665544332211",
      "balance": 45000,
      "createdAt": "2024-06-02T09:00:00.000Z",
      "updatedAt": "2024-06-07T16:20:00.000Z"
    },
    {
      "accountId": "334455667788990011",
      "bankId": "112233445566778800",
      "characterId": "111222333444555666",
      "balance": 12500,
      "createdAt": "2024-06-03T11:30:00.000Z",
      "updatedAt": "2024-06-07T10:05:00.000Z"
    }
  ]
}

Error Responses

Status	Description
`401`	You are not authenticated. Provide a valid authorization token with your request.
`403`	You are not the bank owner and do not hold the `STAFF` permission.
`404`	No bank was found for the given `bankId`.

Overview

Auth & OAuth

Users

Characters

Economy

Banking

Staff

Utilities

GET /v1/banks/:bankId/accounts — List Bank Accounts

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