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.