Skip to main content
GET
/
v1
/
beneficiaries
/
details
Fetch Beneficiary Details v1
curl --request GET \
  --url https://sandbox.api.fin.com/v1/beneficiaries/details \
  --header 'Authorization: Bearer <token>'
{
  "data": {
    "id": "f653e109-6c62-4aa4-869c-418c874e0a6c",
    "customer_id": "ad41fac1-e406-445b-aea4-69381c39ca5d",
    "active": true,
    "country_code": "AUS",
    "first_name": "Michael",
    "last_name": "O'Connor",
    "type": "INDIVIDUAL",
    "nationality": "AUS",
    "email": "michael.oconnor@example.com",
    "phone": "+61412345678",
    "address": "",
    "method": "BANK",
    "currency": "AUD",
    "account_number": "*****6789",
    "refund_wallet_address": "0x1b577931C1cC2765024bFbafad97bCe14FF2e87F",
    "developer_fee_fixed": 1.25,
    "developer_fee_percentage": 0.45,
    "liquidation_address": "0x185571d849dcfefff449bd1e9f847b1322f22834",
    "auto_settlement": false,
    "source_currency": "USDC",
    "source_chain": "POLYGON",
    "created_at": "2025-12-09T14:56:47.916263Z",
    "updated_at": "2025-12-09T14:56:49.1308Z"
  }
}

Authorizations

​
Authorization
string
header
required

Bearer token authentication. Obtain token from /v1/oauth/token endpoint

Query Parameters

​
customer_id
string<uuid>
required

Unique identifier for the customer

​
beneficiary_id
string<uuid>
required

Unique identifier for the beneficiary

Response

Beneficiary details retrieved successfully

​
data
object