# List of Institutions

`GET` `https://api.unusualwhales.com/api/institutions`

Returns a list of institutions.

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


## Authentication

```
Authorization: Bearer YOUR_API_KEY
```

## Query Parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `name` | Institution | No | A large entity that manages funds and investments for others. Queryable by name or cik. |
| `min_total_value` | MinValue | No | The min value of the given field. |
| `max_total_value` | MaxValue | No | The max value of the given field. |
| `min_share_value` | MinValue | No | The min value of the given field. |
| `max_share_value` | MaxValue | No | The max value of the given field. |
| `tags[]` | Institution Tags | No | An array of institution tags |
| `order` | Institutional List 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 |
|-------|------|-------------|
| `buy_value` | Buy Value | The rounded total buy value in the institution's portfolio. |
| `call_holdings` | Call Holding Units | The number of call units in the institution's portfolio. |
| `call_value` | Call Value | The rounded total call value in the institution's portfolio. |
| `cik` | CIK | The institution's CIK. |
| `date` | Report Period End Date | The end date of the report period in ISO format. |
| `debt_holdings` | Debt Holding Units | The number of debt units in the institution's portfolio. |
| `debt_value` | Debt Value | The rounded total debt value in the institution's portfolio. |
| `description` | Description | The institution's description. |
| `filing_date` | Filing Date | The latest filing date in ISO format. |
| `founder_img_url` | Founder Image URL | The URL to the institution's founder's image. |
| `fund_holdings` | Fund Holding Units | The number of fund units in the institution's portfolio. |
| `fund_value` | Fund Value | The rounded total fund value in the institution's portfolio. |
| `is_hedge_fund` | Is Hedge Fund |  |
| `logo_url` | Logo URL | The URL to the institution's logo. |
| `name` | Name | The institution's name. |
| `people` | People | Persons of interest in the institution. |
| `pfd_holdings` | Preferred Share Holding Units | The number of preferred share units in the institution's portfolio. |
| `pfd_value` | Preferred Share Value | The rounded total preferred share value in the institution's portfolio. |
| `put_holdings` | Put Holding Units | The number of put units in the institution's portfolio. |
| `put_value` | Put Value | The rounded total put value in the institution's portfolio. |
| `sell_value` | Sell Value | The rounded total sell value in the institution's portfolio. |
| `share_value` | Share Value | The rounded total share value in the institution's portfolio. |
| `short_name` | Short Name | The institution's short name. |
| `tags` | Tags | Tags related to the institution. |
| `total_value` | Total Value | The rounded total value of the institution's portfolio. |
| `warrant_holdings` | Warrant Holding Units | The number of warrant units in the institution's portfolio. |
| `warrant_value` | Warrant Value | The rounded total warrant value in the institution's portfolio. |
| `website` | Website | The institution's website. |


## Example

### curl

```bash
curl -X GET "https://api.unusualwhales.com/api/institutions" \
  -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/institutions", headers=headers)
response = conn.getresponse()
print(response.read().decode("utf-8"))
```

## Response Example

```json
{
  "data": [
    {
      "buy_value": "359232.0",
      "call_holdings": "359232.0",
      "call_value": "359232.0",
      "cik": "0001791786",
      "date": "2024-12-31",
      "debt_holdings": "359232.0",
      "debt_value": "359232.0",
      "description": "Elliott Management Corporation is an American investment management firm. It is also one of the largest activist funds in the world.",
      "filing_date": "2024-10-01",
      "founder_img_url": "https://storage.googleapis.com/uwassets/institution-img/ELLIOTT%20INVESTMENT%20MANAGEMENT%20L.P.%20Paul%20Singer.jpg",
      "fund_holdings": "359232.0",
      "fund_value": "359232.0",
      "is_hedge_fund": true,
      "logo_url": "https://storage.googleapis.com/uwassets/institution-img/ELLIOTT%20INVESTMENT%20MANAGEMENT%20L.P.%20logo.webp",
      "name": "ELLIOTT INVESTMENT MANAGEMENT L.P.",
      "people": [
        "Paul Singer"
      ],
      "pfd_holdings": "359232.0",
      "pfd_value": "359232.0",
      "put_holdings": "359232.0",
      "put_value": "359232.0",
      "sell_value": "359232.0",
      "share_holdings": "359232.0",
      "share_value": "359232.0",
      "short_name": "Elliott Investment Management",
      "tags": [
        "activist"
      ],
      "total_value": "359232.0",
      "warrant_holdings": "359232.0",
      "warrant_value": "359232.0",
      "website": "https://elliott.com"
    }
  ]
}
```