Skip to main content
GET
/
v1
/
beneficiaries
/
details
Fetch Beneficiary Details
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": "[email protected]",
"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