---
title: "Institutional Portfolio"
method: GET
path: "/institutional/portfolio"
tags: ["Default"]
---

# Institutional Portfolio

`GET /institutional/portfolio`

Get the holdings/portfolio data of institutional investors from 13-F filings. Limit to 1 year of data at a time. You can get a list of supported CIK <a href="/api/v1/institutional/list?token=" target="_blank">here</a>.

## Query parameters

- `cik` string, required
- `from` string, required
- `to` string, required

## Response `200`

successful operation

- InstitutionalPortfolio
  - `name` string — Investor's name.
  - `cik` string — CIK.
  - `data` InstitutionalPortfolioGroup[] — Array of positions.
    - `reportDate` string — Report date.
    - `filingDate` string — Filing date.
    - `portfolio` InstitutionalPortfolioInfo[] — Array of positions.
      - `symbol` string — Symbol.
      - `cusip` string — CUSIP.
      - `name` string — Position's name.
      - `putCall` string — <code>put</code> or <code>call</code> for options.
      - `change` number, float — Number of shares change.
      - `noVoting` number, float — Number of shares with no voting rights.
      - `percentage` number, float — Percentage of portfolio.
      - `share` number, float — Number of shares.
      - `sharedVoting` number, float — Number of shares with shared voting rights.
      - `soleVoting` number, float — Number of shares with sole voting rights.
      - `value` number, float — Position value.

---

[API](https://skmtc.net/finnhub-stock-api/apis/finnhub-api.md) · [All operations](https://skmtc.net/finnhub-stock-api/apis/finnhub-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/finnhub-stock-api/finnhub-api/revisions/415b27331384/schema)
