LIlightsparkdev
KYC/KYB Verifications

Get a beneficial owner

Changed on

Retrieve details of a specific beneficial owner by ID.

get/beneficial-owners/{beneficialOwnerId}

Request

  • Base URL
    https://api.lightspark.com/grid/2025-10-13
  • URL
    https://api.lightspark.com/grid/2025-10-13/beneficial-owners/{beneficialOwnerId}
  • Auth
    HTTP basic

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' | 'HOLD' required

The current KYC status of a customer. HOLD means the customer is placed on hold and may be required to update or provide more information.

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

  • dfe5a02f2feeRevision changes
    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • warning

      added the new ACCOUNT_NOT_FOUND enum value to the response property for the response status

    • warning

      added the new AUTH_METHOD_NOT_FOUND enum value to the response property for the response status

    • warning

      added the new CUSTOMER_NOT_FOUND enum value to the response property for the response status

    • warning

      added the new DOCUMENT_HOLDER_NOT_FOUND enum value to the response property for the response status

    • warning

      added the new HOLD enum value to the response property for the response status

    • warning

      added the new NOT_FOUND enum value to the response property for the response status

    • warning

      added the new PAYMENT_DOCUMENT_NOT_FOUND enum value to the response property for the response status

    • warning

      added the new PAYMENT_URL_NOT_FOUND enum value to the response property for the response status

    • warning

      added the new PLATFORM_NOT_FOUND enum value to the response property for the response status

    • warning

      added the new REQUEST_NOT_FOUND enum value to the response property for the response status

    • warning

      added the new SESSION_NOT_FOUND enum value to the response property for the response status

    • warning

      added the new STABLECOIN_EXTERNAL_ACCOUNT_NOT_FOUND enum value to the response property for the response status

    • warning

      added the new STABLECOIN_NOT_FOUND enum value to the response property for the response status

    • warning

      added the new STABLECOIN_OPERATION_NOT_FOUND enum value to the response property for the response status

    • warning

      added the new STABLECOIN_PROVIDER_ACCOUNT_NOT_FOUND enum value to the response property for the response status

    • warning

      added the new VERIFICATION_NOT_FOUND enum value to the response property for the response status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

  • d0bce562bffdRevision changes
    • warning

      added the new REQUEST_ID_MISSING enum value to the response property for the response status

    • warning

      added the new UMA_NOT_FOUND enum value to the response property for the response status

    • warning

      added the new WALLET_SIGNATURE_BODY_MISMATCH enum value to the response property for the response status

    • warning

      added the new WALLET_SIGNATURE_INVALID enum value to the response property for the response status

    • warning

      added the new WALLET_SIGNATURE_MALFORMED enum value to the response property for the response status

    • warning

      added the new WALLET_SIGNATURE_MISSING enum value to the response property for the response status