---
title: "List Beneficiaries"
method: GET
path: "/v3/beneficiaries"
tags: ["Beneficiaries"]
---

# List Beneficiaries

`GET /v3/beneficiaries`

List all beneficiary bank accounts, custody accounts and wallet accounts.

## Query parameters

- `limit` number
- `pageToken` number

## Response `200`

Success

- Beneficiary[]
  - `id` integer
  - `counterparty_id` integer
  - `aid` string
  - `cid` string
  - `account_type` string
  - `ccy` string
  - `host_name` string
  - `host_hub` string
  - `host_location` string
  - `node_name` string
  - `node_address` string
  - `node_location` string
  - `node_country` string
  - `node_subaddress` string
  - `iban` string
  - `account_label` string
  - `description` string
  - `settlement_reference` string
  - `created_at` string
  - `updated_at` string
  - `partner_id` integer
  - `email` string
  - `pid` string
  - `partner_name` string

---

[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)