stocks tool
Publicstocks_search_ownership_filings
Search Schedule 13D/13G ownership filings, newest first.
Description
Search Schedule 13D/13G ownership filings, newest first.
The event feed behind stocks_get_beneficial_owners: one row per
FILING (not per person), so a monitoring agent can poll "what was
filed since date X" by passing filed_from, or watch one company or
one filer. All filters are optional and combine with AND. Each filing
carries accession_number, schedule_type (13D = activist/control
intent, 13G = passive/institutional), submission_type,
amendment_number, subject identity (subject_name, subject_cik),
cusip, date_of_event, filed_date, and its cover-page
reporting_persons (name, cik, percent_of_class,
shares_beneficially_owned as decimal strings, person_type).
Coverage: structured 13D/13G filings from 2024-12-18 (the SEC's structured-XML mandate) for the S&P 500 pilot subject universe. Quarterly 13F manager snapshots are a different dataset and are NOT served here. An empty page for valid filters is a normal success.
Bounds: default 20, max 100 filings per page; page via
pagination.next_cursor → cursor. Errors carry machine codes:
unknown_entity (with suggestions) for an unknown ticker,
out_of_coverage for a company outside the pilot universe,
bad_parameter for an invalid schedule_type, date range, limit, or
cursor.
Example: stocks_search_ownership_filings(schedule_type="13D", filed_from="2026-06-01").
Parameters
Input schema
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
| ticker | string | null | No | null | Optional subject-company filter by ticker symbol ('AAPL'). Omit to see filings across all covered companies. |
| filer_name | string | null | No | null | Optional case-insensitive substring match on a reporting person's name ('Vanguard', 'Icahn'). |
| schedule_type | string | null | No | null | Optional schedule filter: '13D' (activist/control intent) or '13G' (passive/institutional). Invalid values return bad_parameter. |
| filed_from | string (date) | null | No | null | Earliest filed date to include (inclusive, ISO YYYY-MM-DD). |
| filed_to | string (date) | null | No | null | Latest filed date to include (inclusive, ISO YYYY-MM-DD). |
| limit | integer | No | 20 | Filings to return, newest first (1-100). |
| cursor | string | null | No | null | Opaque pagination cursor from a previous response's `pagination.next_cursor`; omit to start from the newest. |
Provenance
Sources
- sec_edgar_ownershipU.S. Securities and Exchange Commission (EDGAR)
Dataset registry: stocks_ownership_filings