# Institutional Ownership

`GET` `https://api.unusualwhales.com/api/institution/{ticker}/ownership`

The institutional ownership of a given ticker.

If you are looking to build a database of insitutional positions use https://unusualwhales.com/skills/institutional.md


## Authentication

```
Authorization: Bearer YOUR_API_KEY
```

## Path Parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `ticker` | Ticker | Yes | A comma separated list of tickers. To exclude certain tickers prefix the first ticker with a `-`. |

## Query Parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `date` | Report Date | No | The report date in the format of YYYY-MM-DD.
 |
| `start_date` | Institutional Report Start Date | No | A date in the format of YYYY-MM-DD, only institutional holdings with `report_date` values on or after this date will be returned.
 |
| `end_date` | Institutional Report End Date | No | A date in the format of YYYY-MM-DD, only institutional holdings with `report_date` values on or before this date will be returned.
 |
| `tags[]` | Institution Tags | No | An array of institution tags |
| `order` | Institutional Ownership Order By | No | Optional columns to order the result by |
| `order_direction` | OrderDirection | No | Whether to sort descending or ascending. Descending by default. |
| `limit` | Default 500 Max 500 Min 1 | No | How many items to return. Default: 500. Max: 500. Min: 1. |
| `page` | Page | No | Page number (use with limit). Starts on page 0. |


## Response (200)

| Field | Type | Description |
|-------|------|-------------|
| `avg_price` | Avg Price |  |
| `filing_date` | General ISO Date | An ISO date. |
| `first_buy` | General ISO Date | An ISO date. |
| `historical_units` | Historical Units | Historical unit counts. Maximum length = 8. |
| `inst_share_value` | Share Value | The rounded total share value in the institution's portfolio. |
| `inst_value` | Total Value | The rounded total value of the institution's portfolio. |
| `name` | Name | The institution's name. |
| `people` | People | Persons of interest in the institution. |
| `report_date` | General ISO Date | An ISO date. |
| `shares_outstanding` | Shares Outstanding | Total outstanding shares for the ticker. |
| `short_name` | Short Name | The institution's short name. |
| `tags` | Tags | Tags related to the institution. |
| `units` | Units |  |
| `units_change` | Units Change | The change in units |
| `value` | Value | The rounded total value on the reporting date. |


## Example

### curl

```bash
curl -X GET "https://api.unusualwhales.com/api/institution/{ticker}/ownership" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"
```

### Python

```python
import http.client

conn = http.client.HTTPSConnection("api.unusualwhales.com")
headers = {"Authorization": "Bearer YOUR_API_KEY", "Accept": "application/json"}
conn.request("GET", "/api/institution/{ticker}/ownership", headers=headers)
response = conn.getresponse()
print(response.read().decode("utf-8"))
```

## Response Example

```json
{
  "data": [
    {
      "avg_price": "432.31",
      "filing_date": "2024-12-23",
      "first_buy": "2021-02-25",
      "historical_units": [
        4103,
        4423
      ],
      "inst_share_value": "582093953.0",
      "inst_value": "1095205923.0",
      "name": "VANGUARD GROUP INC",
      "people": [
        "John Doe"
      ],
      "report_date": "2024-09-30",
      "shares_outstanding": "148239423.0",
      "short_name": "Vanguard",
      "tags": [
        "value_investor"
      ],
      "units": 5000,
      "units_change": -500,
      "value": "2934823.0"
    }
  ]
}
```