---
title: "Retrieve Institutional Ownership"
method: GET
path: "/api/institution/{ticker}/ownership"
---

# Retrieve Institutional Ownership

`GET /api/institution/{ticker}/ownership`

## Request

- Base URL: `https://api.unusualwhales.com`
- URL: `https://api.unusualwhales.com/api/institution/{ticker}/ownership`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/the-unnatural-group--llc/apis/tradesignals-api/docs/api/institution/:ticker/ownership/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns the institutional ownership of a given ticker.

## Path parameters

- `ticker` string, required

## Query parameters

- `date` string, date
- `limit` integer
- `order` 'name' | 'short_name' | 'first_buy' | 'units' | 'units_change' | 'units_changed' | 'value' | 'avg_price' | 'perc_outstanding' | 'perc_units_changed' | 'activity' | 'perc_inst_value' | 'perc_share_value'
- `order_direction` 'desc' | 'asc'
- `page` integer
- `tags` string[]

## Response `200`

Successful response with institutional ownership data.

- InstitutionOwnershipResponse
  - `data` InstitutionOwnership[]
    - `avg_price` string: Average price of the security.
    - `filing_date` string, date: Filing date for the ownership data.
    - `first_buy` string, date: Date of the first purchase.
    - `historical_units` integer[]: Historical unit counts (max length 8).
    - `inst_share_value` string: Rounded total share value in the institution's portfolio.
    - `inst_value` string: Rounded total value of the institution's portfolio.
    - `name` string: Institution's name.
    - `people` string[]: Persons of interest in the institution.
    - `report_date` string, date: Report date for the ownership data.
    - `shares_outstanding` string: Total outstanding shares for the ticker.
    - `short_name` string: Institution's short name.
    - `tags` string[]: Tags related to the institution.
    - `units` integer: Number of units held.
    - `units_change` integer: Change in units held.
    - `value` integer: Rounded total value on the reporting date.

## Other responses

- `422`: Unprocessable Entity
- `500`: Internal Server Error

---

[API](https://skmtc.dev/the-unnatural-group--llc/apis/tradesignals-api.md) - [All operations](https://skmtc.dev/the-unnatural-group--llc/apis/tradesignals-api/llms.txt) - [OpenAPI document](https://skmtc.dev/the-unnatural-group--llc/apis/tradesignals-api/revisions/0b37cadfb125?raw)