> ## Documentation Index > Fetch the complete documentation index at: https://developer.fin.com/llms.txt > Use this file to discover all available pages before exploring further. # Fetch Beneficiary Details > Retrieve detailed information for a specific beneficiary. Returns structured data for bank accounts, e-wallets, and external crypto wallet destinations. ## OpenAPI ````yaml GET /v2/beneficiaries/details openapi: 3.1.0 info: title: Fin.com API version: 1.0.0 description: >- A simple API specification for Fin.com, a financial services platform that provides a range of banking and payment solutions for businesses and individuals. This API allows developers to integrate Fin.com's services into their applications, enabling functionalities such as customer management, transaction processing, and access to financial data. servers: - url: https://sandbox.api.fin.com description: Sandbox server - url: https://api.fin.com description: Production server security: [] tags: - name: Authentication description: A modified OAuth 2.0 Client Credential Flow - name: Customers description: Customer management and document upload operations - name: Balances description: Retrieve wallet balance information - name: Catalogue description: | A set of endpoints to retrieve contextual data to assemble requests to fin.com's API - name: Beneficiaries description: Manage beneficiary accounts for payments and transfers - name: Transactions description: Transaction history and management for beneficiaries - name: Virtual Accounts description: Create and manage virtual accounts for USD to USDC conversions - name: Fees & FX Rates description: Retrieve fees and foreign exchange rates - name: Crypto Orchestration description: >- Accept crypto deposits from exchange and external wallets and settle them to a destination wallet paths: /v2/beneficiaries/details: get: tags: - Beneficiaries summary: Fetch Beneficiary Details description: >- Retrieve detailed information for a specific beneficiary. Returns structured data for bank accounts, e-wallets, and external crypto wallet destinations. parameters: - name: customer_id in: query required: true schema: type: string format: uuid example: 31526861-ebe0-4f84-a7b2-2c3ec1cc47f9 - name: beneficiary_id in: query required: true schema: type: string format: uuid example: 4c0c63db-580f-4e16-af24-e84ea8937dd8 responses: '200': description: Beneficiary details retrieved successfully content: application/json: schema: type: object properties: data: type: object properties: id: type: string format: uuid example: 4c0c63db-580f-4e16-af24-e84ea8937dd8 customer_id: type: string format: uuid example: 31526861-ebe0-4f84-a7b2-2c3ec1cc47f9 active: type: boolean example: true status: type: string enum: - INITIATED - PROCESSING - ACTIVE - INACTIVE - REJECTED example: ACTIVE counter_party: type: string enum: - FIRST_PARTY - THIRD_PARTY example: FIRST_PARTY currency: type: string example: AUD country: type: string example: AUS account_holder: type: object properties: type: type: string enum: - INDIVIDUAL - BUSINESS example: INDIVIDUAL first_name: type: string example: John last_name: type: string example: Doe business_name: type: string email: type: string format: email example: john.doe@example.com phone: type: string example: '+61412345678' bank_account: type: object properties: bank_name: type: string example: Commonwealth Bank of Australia number: type: string example: '123456782' scheme: type: string example: LOCAL type: type: string enum: - BANK - E_WALLET example: BANK bank_routing: type: array items: type: object properties: scheme: type: string example: BANK_IDENTIFIER name: type: string example: AUS BANK receiver_meta_data: type: object properties: transaction_purpose_id: type: integer example: 1 transaction_purpose_remarks: type: string example: Send to Family & Friends occupation_id: type: integer example: 504 occupation_remarks: type: string example: Software quality assurance analyst and tester relationship: type: string example: FAMILY_MEMBER relationship_remarks: type: string example: Family & Friends nationality: type: string example: AUS bank_address: type: object properties: street_line_1: type: string example: Ground Floor Tower 1, 201 Sussex Street city: type: string example: Sydney state: type: string description: >- State or province. Required. Must be an ISO 3166-2 subdivision code (e.g. US-CA, BD-13). example: AU-SA postcode: type: string example: '2000' country: type: string example: AUS account_holder_address: type: object properties: street_line_1: type: string example: 42 Wallaby Way city: type: string example: Queensland state: type: string description: >- State or province. Required. Must be an ISO 3166-2 subdivision code (e.g. US-CA, BD-13). example: AU-SA postcode: type: string example: '2000' country: type: string example: AUS developer_fee: type: object properties: fixed: type: number example: 1.25 percentage: type: number example: 0.45 deposit_instruction: type: object properties: currency: type: string example: USDC rail: type: string example: POLYGON liquidation_address: type: string example: '0xc0470baa27e383a570226298f598fac0612f1143' refund_instruction: type: object properties: wallet_address: type: string example: '0x1b577931C1cC2765024bFbafad97bCe14FF2e87F' currency: type: string example: USDC rail: type: string example: POLYGON e_wallet: type: object nullable: true properties: scheme: type: string example: BKASH number: type: string example: '+8801688502814' settlement_config: type: object properties: auto_settlement: type: boolean example: false created_at: type: string format: date-time example: '2025-12-31T14:29:07.100041Z' updated_at: type: string format: date-time example: '2025-12-31T14:29:08.675022Z' examples: Bank / Ewallet: summary: Bank or e-wallet beneficiary value: data: id: 4c0c63db-580f-4e16-af24-e84ea8937dd8 customer_id: 31526861-ebe0-4f84-a7b2-2c3ec1cc47f9 active: true status: ACTIVE counter_party: FIRST_PARTY currency: AUD country: AUS account_holder: type: INDIVIDUAL first_name: John last_name: Doe email: john.doe@example.com phone: '+61412345678' bank_account: bank_name: Commonwealth Bank of Australia number: '123456782' scheme: LOCAL type: BANK bank_routing: - scheme: BANK_IDENTIFIER name: AUS BANK receiver_meta_data: transaction_purpose_id: 1 transaction_purpose_remarks: Send to Family & Friends occupation_id: 504 occupation_remarks: Software quality assurance analyst and tester relationship: FAMILY_MEMBER relationship_remarks: Family & Friends nationality: AUS bank_address: street_line_1: Ground Floor Tower 1, 201 Sussex Street city: Sydney state: AU-SA postcode: '2000' country: AUS account_holder_address: street_line_1: 42 Wallaby Way city: Queensland state: AU-SA postcode: '2000' country: AUS developer_fee: fixed: 1.25 percentage: 0.45 deposit_instruction: currency: USDC rail: POLYGON liquidation_address: '0xc0470baa27e383a570226298f598fac0612f1143' refund_instruction: wallet_address: '0x1b577931C1cC2765024bFbafad97bCe14FF2e87F' currency: USDC rail: POLYGON e_wallet: null settlement_config: auto_settlement: false created_at: '2025-12-31T14:29:07.100041Z' updated_at: '2025-12-31T14:29:08.675022Z' '401': $ref: '#/components/responses/AuthenticationError' '404': $ref: '#/components/responses/NotFoundError' security: - bearerAuth: [] components: responses: AuthenticationError: description: Authentication failed due to invalid credentials content: application/json: schema: type: object properties: message: type: string example: Authentication failed NotFoundError: description: Resource not found content: application/json: schema: type: object properties: message: type: string example: Resource not found securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT description: >- Bearer token authentication. Obtain token from [Issue a Token](https://developer.fin.com/api-reference/authentication/issue-a-token) endpoint ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.