Skip to main content
Use these workflows to turn a manager CIK, issuer ticker, or reporting-owner name into a source-cited ownership record. Start with the disclosure family that matches the question: 13F for a manager’s reported holdings, Forms 3/4/5 for reported insider transactions, and Schedule 13D or 13G for beneficial ownership.

​
Get a manager’s latest reported 13F holdings

Pass a manager CIK to GET /v1/owners/13f. The response is a selected 13F report, not a live portfolio. Keep the report date, filing date, accession number, and filing URL with every downstream result.
To select a particular report, use a reportDate or filingDate returned by the filing list:

​
Compare the latest two parsable reports

POST /v1/owners/13f/compare chooses the latest two parsable reports for one manager. It does not accept arbitrary quarter selectors. Use the filings endpoint and individual report requests when you need a specific pair of reports.
The comparison rows identify added, removed, changed, or unchanged positions. A change in reported shares or value is a research lead, not evidence of a current trade, manager intent, or complete exposure.

​
Check institutional holders of one issuer

Use the issuer-centric holder view when the question is who disclosed a position in one security:
This view is based on a 13F cohort. Compare its reportDate, filingDate, and accessionNumber before joining it to a different quarter or calling it current ownership.

​
Find 13D and 13G disclosures

Use GET /v1/owners/13d-13g for beneficial-ownership reports. You can filter by issuer, filer, SEC form, and filing date.
Keep the reported class, ownership percentage, amendment status, filing date, and source filing together. A beneficial-ownership filing is not a real-time cap table or a complete measure of economic exposure.

​
Review reported insider transactions

Use GET /v1/insiders to retrieve normalized records from Forms 3, 4, and 5:
For a narrow Form 4 queue, add a transaction-code filter:
transactionCode and transactionDirection are different fields. Preserve both, along with the transaction date, filing date, accession number, and filing URL. The row may omit a price, title, or post-transaction ownership; leave absent fields absent rather than estimating them.

​
Handle results and failures

List routes return pagination fields such as hasMore and nextCursor; use the returned cursor for the next page. Treat a non-2xx response as a failed request, retain requestId and traceparent for diagnosis, and do not turn an empty result into a claim that an issuer or manager has no relevant disclosure.

​
Continue