Skip to main content
GET
/
v1
/
customers
/
{customer_id}
/
beneficiaries
List Beneficiaries For a Customer
curl --request GET \
  --url https://sandbox.api.fin.com/v1/customers/{customer_id}/beneficiaries \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "f653e109-6c62-4aa4-869c-418c874e0a6c",
      "customer_id": "ad41fac1-e406-445b-aea4-69381c39ca5d",
      "active": true,
      "country_code": "AUS",
      "business_name": "Investment bank",
      "type": "BUSINESS",
      "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"
    },
    {
      "id": "f653e109-6c62-4aa4-869c-418c874e0a6c",
      "customer_id": "ad41fac1-e406-445b-aea4-69381c39ca5d",
      "active": true,
      "country_code": "AUS",
      "business_name": "Investment Money",
      "type": "BUSINESS",
      "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

Path Parameters

customer_id
string<uuid>
required

Unique identifier for the customer

Response

Beneficiaries list retrieved successfully

data
object[]