---
title: "List beneficial owners"
method: GET
path: "/beneficial-owners"
tags: ["KYC/KYB Verifications"]
---

# List beneficial owners

`GET /beneficial-owners`

Retrieve a list of beneficial owners for a business customer.

## Query parameters

- `customerId` string, required
- `limit` integer
- `cursor` string

## Response `200`

Successful operation

- BeneficialOwnerListResponse
  - `data` BeneficialOwner[], required — List of beneficial owners matching the filter criteria
    - `id` string, required — Unique identifier for this beneficial owner
    - `customerId` string, required — The ID of the business customer this beneficial owner is associated with
    - `roles` BeneficialOwnerRole[], required — Roles of this person within the business
    - `ownershipPercentage` integer, required — Percentage of ownership in the business (0-100)
    - `personalInfo` BeneficialOwnerPersonalInfo, required
      - `firstName` string, required — First name of the individual
      - `middleName` string — Middle name of the individual
      - `lastName` string, required — Last name of the individual
      - `birthDate` string, date, required — Date of birth in ISO 8601 format (YYYY-MM-DD)
      - `nationality` string, required — Country of nationality (ISO 3166-1 alpha-2)
      - `email` string, email — Email address of the individual
      - `phoneNumber` string — Phone number in E.164 format
      - `address` Address, required
        - `line1` string, required — Street address line 1
        - `line2` string — Street address line 2
        - `city` string — City
        - `state` string — State/Province/Region
        - `postalCode` string, required — Postal/ZIP code
        - `country` string, required — Country code (ISO 3166-1 alpha-2)
      - `idType` 'SSN' | 'ITIN' | 'EIN' | 'NON_US_TAX_ID', required — Type of tax identification
      - `identifier` string, required — The identification number or value
      - `countryOfIssuance` string — Country that issued the identification (ISO 3166-1 alpha-2)
    - `kycStatus` 'UNVERIFIED' | 'PENDING' | 'APPROVED' | 'REJECTED', required — The current KYC status of a customer
    - `createdAt` string, date-time, required — When this beneficial owner was created
    - `updatedAt` string, date-time — When this beneficial owner was last updated
  - `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

## Other responses

- `400` — Bad request - Invalid parameters
- `401` — Unauthorized
- `500` — Internal service error

---

[API](https://skmtc.net/lightsparkdev/apis/grid-api.md) · [All operations](https://skmtc.net/lightsparkdev/apis/grid-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lightsparkdev/grid-api/versions/d0bce562bffd/schema)