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

# Retrieve Institutional Ownership

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

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.net/the-unnatural-group--llc/apis/tradesignals-api.md) · [All operations](https://skmtc.net/the-unnatural-group--llc/apis/tradesignals-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/the-unnatural-group--llc/tradesignals-api/revisions/0b37cadfb125/schema)