---
title: "List Beneficial Owners"
method: GET
path: "/businesses/{business_id}/beneficial_owners"
tags: ["Businesses"]
---

# List Beneficial Owners

`GET /businesses/{business_id}/beneficial_owners`

## Request

- Base URL: `https://sandbox.api.lemon.markets/v1`
- URL: `https://sandbox.api.lemon.markets/v1/businesses/{business_id}/beneficial_owners`
- Auth: HTTP bearer

## Path parameters

- `business_id` string, required

## Query parameters

- `cursor` string
- `limit` integer

## Headers

- `LMG-Data-Privacy-Access-Principal` string, required
- `LMG-Data-Privacy-Access-Justification` string, required

## Response `200`

Successful Response

- EncodedPaginatedCollectionResponseBeneficialOwnerResponse
  - `data` BeneficialOwnerResponse[], required: The elements of the response.
    - `id` string, required: The unique identifier for this beneficial owner.
    - `person` string, required: A person identifier. This field represents the `person` associated as beneficial owner.
    - `shares_pct` string, number, required: The amount of shares (in percent) held by this beneficial owner.
    - `voting_rights_pct` string, number: The amount of voting rights (in percent) held by this beneficial owner. Required for KYC reliance partners only.
    - `nature` 'real' | 'notional', required: A category describing the nature of a UBO: <ul> <li><code>real</code> <li><code>notional</code> </ul>
  - `pagination` EncodedPaginationResponse, required: Information about accessing elements beyond the ones that were returned.
    - `next_cursor` string: When fetching long lists of elements, you can use our pagination feature to fetch batches of data. If a response contains the property `pagination.next_cursor`, you can pass its value via the query item `cursor` to generate the request for the next batch of data.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `404`: Not Found
- `422`: Unprocessable Entity
- `5XX`: Server Error

---

[API](https://skmtc.dev/lemon/apis/lemon-markets-brokerage-api.md) - [All operations](https://skmtc.dev/lemon/apis/lemon-markets-brokerage-api/llms.txt) - [OpenAPI document](https://skmtc.dev/lemon/apis/lemon-markets-brokerage-api/revisions/1f1df208c0e4?raw)