Plan: Professional and above · Credits: 1 per call
What You Can Use 13F Holdings For
Reconstruct a manager’s disclosed equity portfolio for a quarter, and difference two quarters to see what it bought and sold. List every institution holding a given company, ranked by position value. Measure how concentrated a manager’s book is. Compare what a manager says it does in its Form ADV brochure against what its 13F book actually holds.13F Holdings Coverage
Coverage is US Form 13F filers: institutional investment managers exercising discretion over more than $100 million in 13F-reportable US-listed equities. Managers below that threshold do not file and are absent. Up to eight quarters of history are served per manager.Two Ways to Read 13F Holdings
The dataset is queried in one of two mutually exclusive modes, and exactly one identifier must be supplied. Passingfiler_cik returns one manager’s whole portfolio. This is the mode for “what does this manager own”.
Passing ticker returns every institution holding that security, largest position first. This is the mode for “who owns this company”.
Passing both, or neither, returns a 400.
Key 13F Holdings Fields
ticker, name_of_issuer and cusip identify the held security as the manager reported it. title_of_class is the share class. put_call is populated on option positions and null on ordinary long stock.
report_period is the quarter end the position is as of. filing_date is when the manager filed. form_type distinguishes an original 13F-HR from an amendment. accession_number identifies the filing on EDGAR.
13F Holdings Date Convention
report_period is the quarter end the positions are stated as of — always a calendar quarter end such as 2026-03-31. It is the date to filter and group on.
filing_date is when the manager submitted the form, and it is typically about 45 days after the report period. The gap matters: a position dated 31 March only becomes public in mid-May, so 13F data is never a current picture of a portfolio.
13F Holdings Sources
Positions are read from the managers’ own Form 13F filings on SEC EDGAR. Nothing is estimated, and an amendment is kept as its own filing rather than overwriting the original.Query 13F Holdings
Use the institutional holdings endpoint to retrieve 13F positions. Supply exactly one offiler_cik or ticker to choose the mode.
string
The manager’s SEC CIK. Returns that manager’s portfolio. Exactly one of
filer_cik or ticker is required.string
The held security’s ticker. Returns every institution holding it. Exactly one of
filer_cik or ticker is required.string
Exact quarter end,
YYYY-MM-DD, for example 2026-03-31. Required to read anything other than the most recent quarter.string
Quarter-end lower bound, inclusive.
report_period_lte, report_period_gt and report_period_lt work the same way.integer
default:"1000"
Maximum rows in the response. There is no hard cap. This bounds the whole response, not the rows per quarter, so a multi-quarter request needs a much larger value than a single-quarter one — around 5,000 for a complete eight-quarter holder history on a mega-cap. Leaving it at the default silently truncates such a request to the most recent quarters.
limit-only paging, and return the flat { error, message } error body. See Pagination and Errors.