v1

latestOpenAPI 3.1.02026-07-226250251.5 KB

Beneficiaries

List Beneficiaries For a Customer

Retrieve all beneficiaries associated with a specific customer

get/v1/customers/{customer_id}/beneficiaries

Path parameters

customer_idstring uuid required

Response

Beneficiaries list retrieved successfully

Example response

{
  "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": "michael.oconnor@example.com",
      "phone": "+61412345678",
      "method": "BANK",
      "currency": "AUD",
      "account_number": "*****6789",
      "refund_wallet_address": "0x1b577931C1cC2765024bFbafad97bCe14FF2e87F",
      "developer_fee_fixed": 1.25,
      "developer_fee_percentage": 0.45,
      "liquidation_address": "0x185571d849dcfefff449bd1e9f847b1322f22834",
      "source_currency": "USDC",
      "source_chain": "POLYGON",
      "created_at": "2025-12-09T14:56:47.916263Z",
      "updated_at": "2025-12-09T14:56:49.1308Z"
    }
  ]
}