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

Use this endpoint to retrieve the details of a specific bank account. You can only view an account if one of your own characters owns it, or if your user account holds the STAFF permission. The response includes the account’s current balance and the character it is linked to.

Endpoint

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

Path Parameters

string

required

The Snowflake ID of the bank that holds this account.

string

required

The Snowflake ID of the account you want to retrieve.

Response

A successful 200 response returns the account object:

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/223344556677889900" \
  -H "Authorization: Bearer <your_token>"

Example Response

{
  "accountId": "223344556677889900",
  "bankId": "112233445566778800",
  "characterId": "998877665544332211",
  "balance": 45000,
  "createdAt": "2024-06-02T09:00:00.000Z",
  "updatedAt": "2024-06-07T16:20:00.000Z"
}

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 — Details

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