# Direct holders (New)

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.

**API credits cost:** `1500` per symbol

> **Note:** This API endpoint is available starting with the <a href="https://twelvedata.com/pricing">Ultra</a> plan and currently working in beta for the Tadawul exchange.

## Parameters

- `symbol` (string, optional, see notes)
  Symbol ticker of instrument.
For preffered stocks use dot(.) delimiter.
E.g. `BRK.A` or `BRK.B` will be correct


- `figi` (string, optional, see notes)
  Filter by financial instrument global identifier (FIGI). This request parameter is available starting with the Ultra plan


- `isin` (string, optional, see notes)
  Filter by international securities identification number (ISIN). ISIN access is activating in the Data add-ons section


- `cusip` (string, optional, see notes)
  The CUSIP of an instrument for which data is requested. CUSIP access is activating in the Data add-ons section


- `exchange` (string, optional)
  Exchange where instrument is traded


- `mic_code` (string, optional)
  Market Identifier Code (MIC) under ISO 10383 standard


- `country` (string, optional)
  Country where instrument is traded, e.g., `United States` or `US`


**Notes:**

 - At least one of the following parameters is required: `symbol`, `figi`, `isin`, `cusip`.

## Response

- `meta` (object)
  Meta information about the financial instrument
  - `symbol` (string)
    Ticker symbol of instrument
  - `name` (string)
    Name of symbol
  - `currency` (string)
    Currency of the instrument according to the ISO 4217 standard
  - `exchange` (string)
    Exchange where instrument is traded
  - `mic_code` (string)
    Market identifier code (MIC) under ISO 10383 standard
  - `exchange_timezone` (string)
    Timezone of the exchange

- `direct_holders` (array of object)
  List of direct holders for the financial instrument
  - `entity_name` (string)
    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)
    Represents the percentage of shares outstanding that are owned by the financial institution


## Example Request

```bash
curl "https://api.twelvedata.com/direct_holders?symbol=7203&apikey=demo"
```

## Example Response

```json
{
    "meta": {
        "symbol": "7203",
        "name": "Elm Co.",
        "currency": "SAR",
        "exchange": "Tadawul",
        "mic_code": "XSAU",
        "exchange_timezone": "Asia/Riyadh"
    },
    "direct_holders": [
        {
            "entity_name": "Public Investment Fund (Investment Company)",
            "date_reported": "2025-03-13",
            "shares": 53600000,
            "value": 43148000000,
            "percent_held": 0
        }
    ]
}
```