# Fund holders

The fund holders endpoint provides detailed information about the proportion of a company's stock that is owned by mutual fund holders. It returns data on the number of shares held, the percentage of total shares outstanding, and the names of the mutual funds involved. This endpoint is useful for users looking to understand mutual fund investment in a specific company.

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

> **Note:** This API endpoint is available starting with the [Ultra](https://twelvedata.com/pricing) plan.

## 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

- `fund_holders` (array of object)
  List of fund 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/fund_holders?symbol=AAPL&apikey=demo"
```

## Example Response

```json
{
    "meta": {
        "symbol": "AAPL",
        "name": "Apple Inc",
        "currency": "USD",
        "exchange": "NASDAQ",
        "mic_code": "XNAS",
        "exchange_timezone": "America/New_York"
    },
    "fund_holders": [
        {
            "entity_name": "VANGUARD INDEX FUNDS-Vanguard Total Stock Market Index Fund",
            "date_reported": "2025-09-30",
            "shares": 467135722,
            "value": 129695568698,
            "percent_held": 0.031600002
        }
    ]
}
```