---
title: "Direct holders"
method: GET
path: "/direct_holders"
tags: ["regulatory"]
---

# Direct holders

`GET /direct_holders`

The direct holders endpoint provides detailed information about the number of shares directly held by individuals or entities as recorded in a company's official share registry. This data is essential for understanding the distribution of stock ownership within a company, helping users identify major shareholders and assess shareholder concentration.

## Query parameters

- `symbol` string
- `figi` string
- `isin` string
- `cusip` string
- `exchange` string
- `mic_code` string
- `country` string

## Response `200`

- object
  - `meta` object, required — Meta information about the financial instrument
    - `symbol` string, required — Ticker symbol of instrument
    - `name` string, required — Name of symbol
    - `currency` string, required — Currency of the instrument according to the ISO 4217 standard
    - `exchange` string, required — Exchange where instrument is traded
    - `mic_code` string, required — Market identifier code (MIC) under ISO 10383 standard
    - `exchange_timezone` string, required — Timezone of the exchange
  - `direct_holders` DirectHolderItem[], required — List of direct holders for the financial instrument
    - `entity_name` string, required — Refers to the legal name of the institution
    - `date_reported` string — Refers to date reported
    - `shares` integer — Refers to the number of shares owned
    - `value` integer — Total value of shares owned, calculated by multiplying `shares` by the current price
    - `percent_held` number, double — Represents the percentage of shares outstanding that are owned by the financial institution

## Other responses

- `400`
- `401`
- `403`
- `404`
- `414`
- `429`
- `500`

---

[API](https://skmtc.net/twelvedata/apis/twelve-data-api.md) · [All operations](https://skmtc.net/twelvedata/apis/twelve-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/twelvedata/twelve-data-api/revisions/c4a12725cdb5/schema)