v5

OpenAPI 3.1.0Proprietary2026-08-011476181.4 MB

KYC/KYB Verifications

List beneficial owners

Retrieve a list of beneficial owners for a business customer.

get/beneficial-owners

Query parameters

customerIdstring required

The business customer ID

limitinteger

Maximum number of results to return (default 20, max 100)

cursorstring

Cursor for pagination (returned from previous request)

Response

Successful operation

hasMoreboolean required

Indicates if more results are available beyond this page

nextCursorstring

Cursor to retrieve the next page of results (only present if hasMore is true)

totalCountinteger

Total number of results matching the criteria

Example response

{
  "data": [
    {
      "id": "BeneficialOwner:019542f5-b3e7-1d02-0000-000000000001",
      "customerId": "Customer:019542f5-b3e7-1d02-0000-000000000001",
      "roles": [
        "UBO",
        "DIRECTOR"
      ],
      "ownershipPercentage": 51,
      "personalInfo": {
        "firstName": "Jane",
        "middleName": "Marie",
        "lastName": "Smith",
        "birthDate": "1978-06-15",
        "nationality": "US",
        "email": "jane.smith@acmecorp.com",
        "phoneNumber": "+14155550192",
        "address": {
          "line1": "123 Main Street",
          "line2": "Apt 4B",
          "city": "San Francisco",
          "state": "CA",
          "postalCode": "94105",
          "country": "US"
        },
        "idType": "SSN",
        "identifier": "123-45-6789",
        "countryOfIssuance": "US"
      },
      "kycStatus": "APPROVED",
      "createdAt": "2025-10-03T12:00:00Z",
      "updatedAt": "2025-10-03T12:00:00Z"
    }
  ]
}