---
title: "GET /private/list_address_beneficiaries"
method: GET
path: "/private/list_address_beneficiaries"
tags: ["Wallet", "Private"]
---

# GET /private/list_address_beneficiaries

`GET /private/list_address_beneficiaries`

Lists address beneficiaries with optional filtering and pagination. Returns all saved beneficiary information for addresses, with support for filtering by currency, address, wallet type, VASP details, and date ranges.

**📖 Related Article:** [Managing Withdrawals](https://docs.deribit.com/articles/managing-withdrawals-api)

**Scope:** `wallet:read`

[Try in API console](https://test.deribit.com/api_console?method=%2Fprivate%2Flist_address_beneficiaries)

## Query parameters

- `currency` 'BTC' | 'ETH' | 'STETH' | 'ETHW' | 'USDC' | 'USDT' | 'EURR' | 'SOL' | 'XRP' | 'USYC' | 'PAXG' | 'BNB' | 'USDE' — Currency, i.e `"BTC"`, `"ETH"`, `"USDC"`
- `address` string
- `tag` string
- `created_before` integer — The timestamp (milliseconds since the Unix epoch)
- `created_after` integer — The timestamp (milliseconds since the Unix epoch)
- `updated_before` integer — The timestamp (milliseconds since the Unix epoch)
- `updated_after` integer — The timestamp (milliseconds since the Unix epoch)
- `personal` boolean
- `unhosted` boolean
- `beneficiary_vasp_name` string — Name of beneficiary VASP
- `beneficiary_vasp_did` string — DID of beneficiary VASP
- `beneficiary_vasp_website` string — Website of the beneficiary VASP
- `limit` integer
- `continuation` string

## Response `200`

Success response

- PrivateListAddressBeneficiariesResponse
  - `jsonrpc` '2.0', required — The JSON-RPC version (2.0)
  - `id` integer — The id that was sent in the request
  - `result` object, required
    - `data` AddressBeneficiaryItem[]
      - `currency` 'BTC' | 'ETH' | 'USDC' | 'USDT' | 'EURR', required — Currency, i.e `"BTC"`, `"ETH"`, `"USDC"`
      - `address` string, required — Address in proper format for currency
      - `tag` string, nullable — Tag for XRP addresses (optional)
      - `user_id` integer, required — Unique user identifier
      - `agreed` boolean, required — Indicates that the user agreed to shared provided information with 3rd parties
      - `personal` boolean, required — The user confirms that he provided address belongs to him and he has access to it via an un-hosted wallet software
      - `unhosted` boolean, required — Indicates if the address belongs to an unhosted wallet
      - `beneficiary_vasp_name` string, required — Name of beneficiary VASP
      - `beneficiary_vasp_did` string, required — DID of beneficiary VASP
      - `beneficiary_vasp_website` string — Website of the beneficiary VASP
      - `beneficiary_first_name` string — First name of the beneficiary (if beneficiary is a person)
      - `beneficiary_last_name` string — Last name of the beneficiary (if beneficiary is a person)
      - `beneficiary_company_name` string — Company name of the beneficiary (if beneficiary is a company)
      - `beneficiary_address` string, required — Geographical address of the beneficiary
      - `created` integer, required — The timestamp (milliseconds since the Unix epoch)
      - `updated` integer, required — The timestamp (milliseconds since the Unix epoch)
    - `continuation` string — Continuation token for pagination.
    - `count` integer — Total number of results available

---

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