Overview

Per-ticker ownership snapshot grouped by reported_date, with one row per owner per group. Captures executives, directors, 5–10% holders, and 10%+ holders along with their common shares, preferred, options, warrants, convertibles, and restricted-stock units.

When to use

Building an insider-activity feed.
Quantifying how much locked-up stock sits behind the float.
Spotting new 10%+ filers.

Key parameters

ticker (required) — single symbol.

Response highlights

Each result is a group keyed by reported_date, containing an owners list. Per-owner fields:

owner_name, owner_type (e.g. Executive, Director, 10+ Percent Investor, 5-10 Percent Investor), title.
common_shares_amount, preferred_shares_amount, options_amount, warrants_amount, shares_underlying_convertibles, restricted_stock_units.
outstanding_shares_final — for computing ownership percentages.
form_type, filed_at, document_url, cik, classes_details, source_table.

Notes

Returns 5–10 most recent grouped reports by default — paginate via page / limit to walk further back.

200Success Ownership

401Invalid or missing API key

402Insufficient credits

403Endpoint not allowed for your organization or API key

422Validation Error

429Rate limit or trial ticker limit exceeded