Dashboard

Ownership summary

GET/api/ownership/summary

Pro

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 complete 13F quarter: a quarter appears 50 days after its end, once managers have filed. 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

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

{
  "error": "Error description goes here"
}

403 Forbidden

Feature not available on current plan

Response schema

  • error string

    Human-readable error message

Example response

{
  "error": "Error description goes here"
}