Get a beneficial owner

Retrieve details of a specific beneficial owner by ID.

get/beneficial-owners/{beneficialOwnerId}

Path parameters

beneficialOwnerIdstring required

Beneficial owner ID

Response

Successful operation

idstring required

Unique identifier for this beneficial owner

customerIdstring required

The ID of the business customer this beneficial owner is associated with

rolesBeneficialOwnerRole[] required

Roles of this person within the business

ownershipPercentageinteger required

Percentage of ownership in the business (0-100)

kycStatus'UNVERIFIED' | 'PENDING' | 'APPROVED' | 'REJECTED' required

The current KYC status of a customer

createdAtstring date-time required

When this beneficial owner was created

updatedAtstring date-time

When this beneficial owner was last updated

Example response

{
  "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 2 of the 33 revisions of this API.61

May 28, 2026d0bce562bffd6See the full diff
- ●
  added the new REQUEST_ID_MISSING enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new UMA_NOT_FOUND enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new WALLET_SIGNATURE_BODY_MISMATCH enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new WALLET_SIGNATURE_INVALID enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new WALLET_SIGNATURE_MALFORMED enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new WALLET_SIGNATURE_MISSING enum value to the response property for the response status
  response-property-enum-value-added
This revision also has 6 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Apr 27, 20265b8a8161eeb31See the full diff
- ○
  endpoint added
  endpoint-added
This revision also has 15 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history