Sign in
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"
    }
  ]
}

Changes

Changed in 5 of the 24 revisions of this API.41

  • aaa1fb8782c81See the full diff
    • ●

      added the new EXTERNAL_ACCOUNT_VERIFICATION_REQUIRED enum value to the code response property for the response status 400

      response-property-enum-value-added

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • df12ec487f0e1See the full diff
    • ●

      added the new TRANSACTION_SIZE_LIMIT_EXCEEDED enum value to the code response property for the response status 400

      response-property-enum-value-added

  • b06902b6595a1See the full diff
    • ●

      added the new CARDHOLDER_KYC_NOT_APPROVED enum value to the code response property for the response status 400

      response-property-enum-value-added

  • 526036c126091See the full diff
    • ●

      added the new END_USER_TERMS_VERSION_NOT_FOUND enum value to the code response property for the response status 400

      response-property-enum-value-added

  • b21ed434ee6e1See the full diff
    • ○

      added the optional property details/errors to the response with the 400 status

      response-optional-property-added