Ownership summary

GET/api/ownership/summary

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.

Get API key Try it live in the API explorer

Query parameters

symbol string optional min length 1 · max length 10

Stock ticker symbol. Identify the entity by exactly one of: symbol, cik, cusip, composite_figi, or share_class_figi. At least one is required.

Example: AAPL
cik integer optional

SEC Central Index Key (CIK).

Example: 320193
cusip string optional min length 9 · max length 9

CUSIP identifier (9 characters).

Example: 037833100
composite_figi string optional

Composite OpenFIGI identifier.

Example: BBG000B9XRY4
share_class_figi string optional

Share-class OpenFIGI identifier.

Example: BBG001S5N8V8

Example request

curl 'https://api.stockfit.io/v1/api/ownership/summary?symbol=AAPL&cik=320193&cusip=037833100&composite_figi=BBG000B9XRY4&share_class_figi=BBG001S5N8V8' \
  -H 'Authorization: Bearer YOUR_API_TOKEN'

Responses

200 OK

Aggregate ownership breakdown

Response schema

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 | null
  Quarter end date of the latest 13F data
- topHolders array of object
  Top 10 institutional holders by value, deduplicated by manager CIK
  array of:
  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 array of object
    Top 5 quarter-over-quarter position increases (largest deltaShares first)
    array of:
    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 array of object
    Top 5 quarter-over-quarter position decreases (most negative deltaShares first)
    array of:
    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)

Example response

{
  "sharesOutstanding": 14700000000,
  "institutional": {
    "holderCount": 2847,
    "totalShares": 10234567890,
    "totalValue": 2891234567000,
    "pctOfSharesOutstanding": 69.62,
    "reportDate": "2025-12-31",
    "topHolders": [
      {
        "managerName": "BlackRock, Inc.",
        "managerCik": 2012383,
        "shares": 1157054556,
        "value": 314465315556,
        "pctOfShares": 7.87
      }
    ],
    "votingAuthority": {
      "sole": 8123456789,
      "shared": 234567890,
      "none": 12345678
    },
    "topQoqMovers": {
      "increases": [
        {
          "managerName": "BlackRock, Inc.",
          "managerCik": 2012383,
          "shares": 1157054556,
          "prevShares": 1100000000,
          "deltaShares": 57054556,
          "deltaPct": 5.2,
          "pctOfShares": 7.87
        }
      ],
      "decreases": [
        {
          "managerName": "Vanguard Group Inc.",
          "managerCik": 102909,
          "shares": 980000000,
          "prevShares": 1050000000,
          "deltaShares": -70000000,
          "deltaPct": -6.7,
          "pctOfShares": 6.67
        }
      ]
    }
  },
  "beneficialOwnerCount": 3,
  "insiderCount": 12
}

400 Bad Request

Invalid parameters or company not found

Response schema

error string
Human-readable error message

Example response

{}

403 Forbidden

Feature not available on current plan

Response schema

error string
Human-readable error message

Example response

{}