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

# GET /private/get_address_beneficiary

`GET /private/get_address_beneficiary`

Retrieves beneficiary information for a specific address. Returns the stored beneficiary details including VASP information, personal details, and wallet type classification.

**📖 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%2Fget_address_beneficiary)

## Query parameters

- `currency` 'BTC' | 'ETH' | 'STETH' | 'ETHW' | 'USDC' | 'USDT' | 'EURR' | 'SOL' | 'XRP' | 'USYC' | 'PAXG' | 'BNB' | 'USDE', required — Currency, i.e `"BTC"`, `"ETH"`, `"USDC"`
- `address` string, required
- `tag` string

## Response `200`

Success response

- PrivateGetAddressBeneficiaryResponse
  - `jsonrpc` '2.0', required — The JSON-RPC version (2.0)
  - `id` integer — The id that was sent in the request
  - `result` AddressBeneficiaryItem, required
    - `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)

---

[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/versions/78a0783dbfcc/schema)