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

> Retrieve a single bank account by ID. Returns balance and linked character ID. Requires that one of your characters owns the account, or STAFF permission.

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

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

## Path Parameters

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

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

## Response

A successful `200` response returns the account object:

<ResponseField name="accountId" type="string">
  The unique Snowflake ID for this bank account.
</ResponseField>

<ResponseField name="bankId" type="string">
  The Snowflake ID of the bank this account belongs to.
</ResponseField>

<ResponseField name="characterId" type="string">
  The `characterId` of the character who owns this account.
</ResponseField>

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

<ResponseField name="createdAt" type="string">
  ISO 8601 timestamp of when the account was opened.
</ResponseField>

<ResponseField name="updatedAt" type="string">
  ISO 8601 timestamp of when the account was last modified.
</ResponseField>

## Example Request

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

## Example Response

```json theme={null}
{
  "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.                     |