---
title: "Ownership summary"
method: GET
path: "/api/ownership/summary"
tags: ["Ownership"]
---

# Ownership summary

`GET /api/ownership/summary`

![Stock](https://img.shields.io/badge/Stock-f97316) ![Pro](https://img.shields.io/badge/Pro-8b5cf6)

Returns an aggregate ownership breakdown for a stock: total institutional ownership percentage, holder count, top 10 holders, beneficial owner count, and insider count.
Institutional data is from the latest 13F quarter. Ownership percentage is calculated against shares outstanding.

For symbols without an issuer-level shares-outstanding figure (e.g. ETFs, funds), the `sharesOutstanding`, `institutional.pctOfSharesOutstanding`, and per-holder `pctOfShares` fields are omitted from the response.

## Query parameters

- `symbol` string
- `cik` integer
- `cusip` string
- `composite_figi` string
- `share_class_figi` string

## Response `200`

Aggregate ownership breakdown

- object
  - `sharesOutstanding` number — Total shares outstanding from the latest filing. Omitted when no issuer-level shares-outstanding figure is available (e.g. for ETFs/funds).
  - `institutional` object
    - `holderCount` integer — Number of distinct institutional holders
    - `totalShares` number — Total shares held by institutions
    - `totalValue` number — Total market value of institutional holdings (USD)
    - `pctOfSharesOutstanding` number — Institutional ownership as percentage of shares outstanding. Omitted when `sharesOutstanding` is unavailable.
    - `reportDate` string, nullable — Quarter end date of the latest 13F data
    - `topHolders` object[] — Top 10 institutional holders by value, deduplicated by manager CIK
      - `managerName` string
      - `managerCik` integer
      - `shares` number
      - `value` number
      - `pctOfShares` number — Holder's position as percentage of shares outstanding. Omitted when `sharesOutstanding` is unavailable.
    - `votingAuthority` object — Aggregate voting authority across all institutional holdings in the latest quarter — sums of shares where managers have sole, shared, or no voting power
      - `sole` number — Total shares with sole voting authority
      - `shared` number — Total shares with shared voting authority
      - `none` number — Total shares with no voting authority
    - `topQoqMovers` object — Top 5 increases and top 5 decreases in institutional positions between the two most recent reporting quarters, ranked by absolute share count delta. Aggregated per manager CIK. Movers with absolute deltas under 1,000 shares are excluded.
      - `increases` object[] — Top 5 quarter-over-quarter position increases (largest deltaShares first)
        - `managerName` string
        - `managerCik` integer
        - `shares` number — Current quarter share count (aggregated across this manager's positions)
        - `prevShares` number — Prior quarter share count
        - `deltaShares` number — Change in share count (current − previous; negative for decreases)
        - `deltaPct` number — Percentage change in share count (rounded to 1 decimal)
        - `pctOfShares` number — Manager's current position as percentage of shares outstanding (rounded to 2 decimals)
      - `decreases` object[] — Top 5 quarter-over-quarter position decreases (most negative deltaShares first)
        - `managerName` string
        - `managerCik` integer
        - `shares` number — Current quarter share count (aggregated across this manager's positions)
        - `prevShares` number — Prior quarter share count
        - `deltaShares` number — Change in share count (current − previous; negative for decreases)
        - `deltaPct` number — Percentage change in share count (rounded to 1 decimal)
        - `pctOfShares` number — Manager's current position as percentage of shares outstanding (rounded to 2 decimals)
  - `beneficialOwnerCount` integer — Number of 5%+ beneficial owners (Schedule 13D/13G filers)
  - `insiderCount` integer — Number of distinct company insiders (officers and directors)

## Other responses

- `400` — Invalid parameters or company not found
- `403` — Feature not available on current plan

---

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