Skip to main content
GET
/
beneficial-owners
List beneficial owners
curl --request GET \
  --url https://api.lightspark.com/grid/2025-10-13/beneficial-owners \
  --header 'Authorization: Basic <encoded-value>'
{
  "data": [
    {
      "id": "BeneficialOwner:019542f5-b3e7-1d02-0000-000000000001",
      "customerId": "Customer:019542f5-b3e7-1d02-0000-000000000001",
      "roles": [
        "UBO",
        "DIRECTOR"
      ],
      "personalInfo": {
        "firstName": "Jane",
        "lastName": "Smith",
        "birthDate": "1978-06-15",
        "nationality": "US",
        "address": {
          "line1": "123 Main Street",
          "postalCode": "94105",
          "country": "US",
          "line2": "Apt 4B",
          "city": "San Francisco",
          "state": "CA"
        },
        "personalIds": {
          "idType": "SSN",
          "identifier": "123-45-6789",
          "countryOfIssuance": "US"
        },
        "middleName": "Marie",
        "email": "jane.smith@acmecorp.com",
        "phoneNumber": "+14155550192"
      },
      "kycStatus": "APPROVED",
      "createdAt": "2025-10-03T12:00:00Z",
      "ownershipPercentage": 51,
      "updatedAt": "2025-10-03T12:00:00Z"
    }
  ],
  "hasMore": true,
  "nextCursor": "<string>",
  "totalCount": 123
}

Authorizations

​
Authorization
string
header
required

API token authentication using format <api token id>:<api client secret>

Query Parameters

​
customerId
string

Filter by business customer ID

​
role
enum<string>

Filter by role Role of the beneficial owner within the business

Available options:
UBO,
DIRECTOR,
COMPANY_OFFICER,
CONTROL_PERSON,
TRUSTEE,
GENERAL_PARTNER
Example:

"UBO"

​
limit
integer
default:20

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

Required range: 1 <= x <= 100
​
cursor
string

Cursor for pagination (returned from previous request)

Response

Successful operation

​
data
object[]
required

List of beneficial owners matching the filter criteria

​
hasMore
boolean
required

Indicates if more results are available beyond this page

​
nextCursor
string

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

​
totalCount
integer

Total number of results matching the criteria