---
title: "Accounts"
method: GET
path: "/v3/accounts"
tags: ["Accounts"]
---

# Accounts

`GET /v3/accounts`

List Accounts

## Query parameters

- `counterparty_id` integer
- `id` integer
- `limit` integer
- `pageToken` integer

## Response `200`

Success

- Account[]
  - `id` integer, required — Account ID
  - `counterparty_id` integer, required — Counterparty ID
  - `aid` string — Alpha-numeric account ID
  - `cid` string — Alpha-numeric counterparty ID
  - `account_type` 'Bank' | 'Custodial' | 'Wallet'
  - `ccy` string — Asset ticker, or left hand side of trading symbol
  - `host_name` string — Bank Name for bank accounts, Custodian Name for custody accounts, Wallet Name for wallet accounts
  - `host_hub` string — Branch Code for bank accounts, optional for custody and wallets
  - `host_location` string
  - `node_name` string — Account holder's legal name
  - `node_address` string — Account Number for bank accounts, wallet address for wallets, optional for custody
  - `node_location` string — Account holder's residential address for bank accounts, optional memo field for custody and wallets
  - `node_country` string — Account holder's residential address country code (2-letter ISO country code), optional memo field for custody and wallets
  - `iban` string — IBAN for bank accounts
  - `account_label` string — Display name for account
  - `description` string — Free-text description of account
  - `bcb_controlled` string — Flag is 1 if BCB can operate the account, 0 otherwise
  - `settlement_reference` string — Optional settlement reference for payments
  - `created_at` string — Timestamp of account record creation (YYYY-MM-DDTHH:MM:SS.000Z)
  - `updated_at` string — Timestamp of account record update (YYYY-MM-DDTHH:MM:SS.000Z)
  - `blinc_id` string — Only applicable to BLINC accounts - account id within BLINC network
  - `partner_id` string — This field is deprecated.
  - `email` string — Email address of client
  - `reporting_ccy` string — Home currency of client
  - `pid` string — This field is deprecated.
  - `partner_name` string — This field is deprecated.

## Other responses

- `401` — Unauthorized
- `500` — Internal Server Error

---

[API](https://skmtc.net/bcb/apis/payments-api.md) · [All operations](https://skmtc.net/bcb/apis/payments-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bcb/payments-api/revisions/7559660d5268/schema)