StockOwnership

Every disclosed holder of a stock or ETF listing in one list: 13F institutions, Schedule 13D and 13G filers, insiders (Forms 3, 4 and 5, primary listing only), registered funds (each series' latest N-PORT) and non-US disclosures. view=default gives one row per holder from its freshest filing, with its other filings and the 13D/G, insider and fund disclosures its 13F report holds nested under it, matched by CIK and SEC reporting links, never by name; zero balances, insider filings older than 24 months and 13D/G filings older than the 13F quarter that covers them are hidden. view=all, or a source filter, lists every row flat with stale ones flagged. view=ultimate groups the summed holders under their ultimate parent. Shares are restated onto today's split basis and change compares each row with the same holder's previous filing in the same source.

get/v1/stocks/{ticker}/holders

Request

Path parameters

tickerstring required

Listed security ticker (e.g. NVDA or VOO).

Query parameters

limitinteger

Maximum rows to return (1–500; default varies per endpoint).

offsetinteger

Rows to skip before the first returned row (default 0).

sourcestring

Rows to list: all (default), 13f, 13dg (13D and 13G), 13d, 13g, insider, fund or nonus. A single source lists its rows flat, stale ones flagged.

viewstring

default (one row per holder, others nested), all (every row flat, stale included) or ultimate (summed holders grouped by ultimate parent; takes no source or holderTypes filter).

holderTypesstring

Comma-separated holder type tokens to keep: adv, era, ia, bank, ins, bd, fund, plan, nonus, hc, unk (insiders and holders without a deciding record read unk).

Response

OK

tickerstring nullable

The listed ticker read: the requested ETF series or share class, or the company's primary listing.

exactListingboolean

True when the listing is read on its own (an ETF series or a sibling share class): insiders and percentages are issuer-wide, so they are left out.

reportDatestring date nullable

The 13F quarter the 13F rows present; null when the listing has no 13F rows.

carriedFromstring date nullable

For a combined 13F quarter (its filing window is still open), the quarter whose positions filers yet to file carry; otherwise null.

viewstring nullable

default, all or ultimate.

sourcestring nullable

The source filter applied: all, 13f, 13dg, 13d, 13g, insider, fund or nonus.

sharesOutstandinginteger nullable

The issuer's common shares on today's split basis that percentOutstanding divides by; null when unavailable.

percentUnavailableReasonstring nullable

Why percentages of shares outstanding are unavailable; null when they are available.

Changes

No recorded changes to this operation across all 1 revision of this API.