---
title: "List Beneficial Owners"
method: GET
path: "/entity_beneficial_owners"
---

# List Beneficial Owners

`GET /entity_beneficial_owners`

## Query parameters

- `cursor` string — Return the page of entries after this one.
- `limit` integer — Limit the size of the list that is returned. The default (and maximum) is 100 objects.
- `entity_id` string, required — The identifier of the Entity to list beneficial owners for. Only `corporation` entities have beneficial owners.
- `idempotency_key` string — Filter records to the one with the specified `idempotency_key` you chose for that object. This value is unique across Increase and is used to ensure that a request is only processed once. Learn more about [idempotency](https://increase.com/documentation/idempotency-keys).

## Response `200`

Beneficial Owner List

- EntityBeneficialOwnerList — A list of Beneficial Owner objects.
  - `data` EntityBeneficialOwner[], required — The contents of the list.
    - `company_title` string, nullable, required — This person's role or title within the entity.
    - `created_at` string, date-time, required — The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) time at which the Beneficial Owner was created.
    - `entity_id` string, required — The identifier of the Entity to which this beneficial owner belongs.
    - `id` string, required — The identifier of this beneficial owner.
    - `idempotency_key` string, nullable, required — The idempotency key you chose for this object. This value is unique across Increase and is used to ensure that a request is only processed once. Learn more about [idempotency](https://increase.com/documentation/idempotency-keys).
    - `individual` object, required — Personal details for the beneficial owner.
      - `address` object, required — The person's address.
        - `city` string, nullable, required — The city, district, town, or village of the address.
        - `country` string, required — The two-letter ISO 3166-1 alpha-2 code for the country of the address.
        - `line1` string, required — The first line of the address.
        - `line2` string, nullable, required — The second line of the address.
        - `state` string, nullable, required — The two-letter United States Postal Service (USPS) abbreviation for the US state, province, or region of the address.
        - `zip` string, nullable, required — The ZIP or postal code of the address.
      - `date_of_birth` string, date, required — The person's date of birth in YYYY-MM-DD format.
      - `identification` object, nullable, required — A means of verifying the person's identity.
        - `method` 'social_security_number' | 'individual_taxpayer_identification_number' | 'passport' | 'drivers_license' | 'other', required — A method that can be used to verify the individual's identity.
        - `number_last4` string, required — The last 4 digits of the identification number that can be used to verify the individual's identity.
      - `name` string, required — The person's legal name.
    - `prongs` string[], required — Why this person is considered a beneficial owner of the entity.
    - `type` 'entity_beneficial_owner', required — A constant representing the object's type. For this resource it will always be `entity_beneficial_owner`.
  - `next_cursor` string, nullable, required — A pointer to a place in the list. Pass this as the `cursor` parameter to retrieve the next page of results. If there are no more results, the value will be `null`.

## Other responses

- `4XX` — Error
- `5XX` — Error

---

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