List All Beneficial Owners (Customer Account)

Retrieve all Beneficial Owners for a Business Customer Account.

Endpoint

GET /v1/customers/{customerId}/beneficiaries

Authorization Header

Authorization: Bearer <access_token>

Path Parameters

customerId REQUIRED

string (UUID)

ID of the Business Customer Account.

Request Body

None

Returns

Returns a response with an array of Beneficial Owner Summary objects.

SAMPLE RESPONSE

				
					[
  {
    "parentId": "69248436-39f5-4074-9823-76d2580c82a6",
    "id": "997dec9d-afcb-4843-a9e3-5333b6228229",
    "firstName": "Natalie",
    "middleName": "Sue",
    "lastName": "Smith",
    "primaryPhoneNumber": {
      "number": "+17512312345",
      "type": "MOBILE",
      "provider": "XYZ Mobile",
      "verified": false
    },
    "primaryEmail": {
      "value": "nsmith@example.com",
      "verified": false
    },
    "controller": true,
    "verificationStatus": {
      "status": "UNVERIFIED",
      "reason": "Processing",
      "updatedAt": "2024-08-12T01:09:27.246Z",
      "updatedBy": {
        "id": "cb51cced-fb9a-43cd-abc8-c6842c871262",
        "type": "employee"
      }
    }
  },
  {...},
  {...}
]