---
title: "List transfer beneficiaries"
method: GET
path: "/payment/v1/transfers/{walletId}/beneficiaries"
tags: ["Fiat Payments"]
---

# List transfer beneficiaries

`GET /payment/v1/transfers/{walletId}/beneficiaries`

## Request

- Base URL: `https://api.sandbox.bvnk.com`
- URL: `https://api.sandbox.bvnk.com/payment/v1/transfers/{walletId}/beneficiaries`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/bvnk/apis/bvnk-api-endpoints/docs/payment/v1/transfers/:walletId/beneficiaries/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieves a list of beneficiaries eligible for transfers for a specified wallet.

## Path parameters

- `walletId` string, uuid, required

## Query parameters

- `currencyCode` string, required
- `walletType` string
- `customerReference` string, uuid

## Response `200`

OK

- TransferBeneficiaryResponse[]
  - `walletId` string: The unique identifier of the wallet.
  - `name` string: Name of the wallet.
  - `balance` Money
    - `value` number, float, required: Transfer amount in major currency units.
    - `currency` 'USD' | 'EUR' | 'GBP', required: Three-letter ISO-4217 currency code.
  - `walletType` 'CUSTOMER' | 'MAIN': The type of the wallet

## Other responses

- `403`: Forbidden

## Changes

- **2026-06-16** `97d6c0d2fe2e`: 1 breaking, 1 warning, 1 info
  - the `details/errors` response's property type changed from `object` to `array` for status `403`
  - removed the optional property `details/errors/requestBody` from the response with the `403` status
  - added the required property `traceId` to the response with the `403` status

[Operation history](https://skmtc.dev/bvnk/apis/bvnk-api-endpoints/changes/payment/v1/transfers/:walletId/beneficiaries/get.md)

---

[API](https://skmtc.dev/bvnk/apis/bvnk-api-endpoints.md) - [All operations](https://skmtc.dev/bvnk/apis/bvnk-api-endpoints/llms.txt) - [OpenAPI document](https://skmtc.dev/bvnk/apis/bvnk-api-endpoints/revisions/c386d436bf2c?raw)