---
title: "Fetch Beneficiary Details v2"
method: GET
path: "/v2/beneficiaries/details"
tags: ["Beneficiaries"]
---

# Fetch Beneficiary Details v2

`GET /v2/beneficiaries/details`

Retrieve detailed information for a specific beneficiary. Returns structured data for bank accounts, e-wallets, and external crypto wallet destinations.

## Query parameters

- `customer_id` string, uuid, required
- `beneficiary_id` string, uuid, required

## Response `200`

Beneficiary details retrieved successfully

- object
  - `data` object
    - `id` string, uuid
    - `customer_id` string, uuid
    - `active` boolean
    - `status` 'INITIATED' | 'PROCESSING' | 'ACTIVE' | 'INACTIVE' | 'REJECTED'
    - `counter_party` 'FIRST_PARTY' | 'THIRD_PARTY'
    - `currency` string
    - `country` string
    - `account_holder` object
      - `type` 'INDIVIDUAL' | 'BUSINESS'
      - `first_name` string
      - `last_name` string
      - `business_name` string
      - `email` string, email
      - `phone` string
    - `bank_account` object
      - `bank_name` string
      - `number` string
      - `scheme` string
      - `type` 'BANK' | 'E_WALLET'
    - `bank_routing` object[]
      - `scheme` string
      - `name` string
    - `receiver_meta_data` object
      - `transaction_purpose_id` integer
      - `transaction_purpose_remarks` string
      - `occupation_id` integer
      - `occupation_remarks` string
      - `relationship` string
      - `relationship_remarks` string
      - `nationality` string
    - `bank_address` object
      - `street_line_1` string
      - `city` string
      - `state` string — State or province. Required. Must be an ISO 3166-2 subdivision code (e.g. US-CA, BD-13).
      - `postcode` string
      - `country` string
    - `account_holder_address` object
      - `street_line_1` string
      - `city` string
      - `state` string — State or province. Required. Must be an ISO 3166-2 subdivision code (e.g. US-CA, BD-13).
      - `postcode` string
      - `country` string
    - `developer_fee` object
      - `fixed` number
      - `percentage` number
    - `deposit_instruction` object
      - `currency` string
      - `rail` string
      - `liquidation_address` string
    - `refund_instruction` object
      - `wallet_address` string
      - `currency` string
      - `rail` string
    - `e_wallet` object, nullable
      - `scheme` string
      - `number` string
    - `settlement_config` object
      - `auto_settlement` boolean
    - `destination_wallet` object, nullable
      - `address` string
      - `currency` string
      - `rail` string
    - `created_at` string, date-time
    - `updated_at` string, date-time

## Other responses

- `401` — Authentication failed due to invalid credentials
- `404` — Resource not found

---

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