---
title: "Retrieve List of Institutions"
method: GET
path: "/api/institutions"
---

# Retrieve List of Institutions

`GET /api/institutions`

Returns a list of institutions.

## Query parameters

- `limit` integer
- `max_share_value` string
- `max_total_value` string
- `min_share_value` string
- `min_total_value` string
- `name` string
- `order` 'name' | 'call_value' | 'put_value' | 'share_value' | 'call_holdings' | 'put_holdings' | 'share_holdings' | 'total_value' | 'warrant_value' | 'fund_value' | 'pfd_value' | 'debt_value' | 'total_holdings' | 'warrant_holdings' | 'fund_holdings' | 'pfd_holdings' | 'debt_holdings' | 'percent_of_total' | 'date' | 'buy_value' | 'sell_value'
- `order_direction` 'desc' | 'asc'
- `page` integer
- `tags` string[]

## Response `200`

Successful response with a list of institutions.

- InstitutionsResponse
  - `data` Institution[]
    - `buy_value` string — Rounded total buy value in the institution's portfolio.
    - `call_holdings` string — Number of call units in the institution's portfolio.
    - `call_value` string — Rounded total call value in the institution's portfolio.
    - `cik` string — The institution's CIK.
    - `date` string, date — End date of the report period in ISO format.
    - `debt_holdings` string — Number of debt units in the institution's portfolio.
    - `debt_value` string — Rounded total debt value in the institution's portfolio.
    - `filing_date` string, date — Latest filing date in ISO format.
    - `fund_holdings` string — Number of fund units in the institution's portfolio.
    - `fund_value` string — Rounded total fund value in the institution's portfolio.
    - `is_hedge_fund` boolean — Indicates whether the institution is a hedge fund.
    - `name` string — The institution's name.
    - `people` string[] — Persons of interest in the institution.
    - `pfd_holdings` string — Number of preferred share units in the institution's portfolio.
    - `pfd_value` string — Rounded total preferred share value in the institution's portfolio.
    - `put_holdings` string — Number of put units in the institution's portfolio.
    - `put_value` string — Rounded total put value in the institution's portfolio.
    - `sell_value` string — Rounded total sell value in the institution's portfolio.
    - `share_value` string — Rounded total share value in the institution's portfolio.
    - `short_name` string — The institution's short name.
    - `tags` string[] — Tags related to the institution.
    - `total_value` string — Rounded total value of the institution's portfolio.
    - `warrant_holdings` string — Number of warrant units in the institution's portfolio.
    - `warrant_value` string — Rounded total warrant value in the institution's portfolio.

## 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/versions/0b37cadfb125/schema)