Get Beneficial Owners
secedgar_get_beneficial_ownersList the 5%-and-over beneficial owners of a public company, parsed from the structured SCHEDULE 13D and SCHEDULE 13G filings made about it. The input is the ISSUER — the company being held — which is the opposite direction from secedgar_get_institutional_holdings, where the input is the manager. 13D is the activist form and carries the filer's stated purpose of the transaction; 13G is the passive form and has no purpose field at all, which is the substantive difference between a stake that intends to influence control and one that does not. Every filing is returned with each reporting person listed separately, because voting power, dispositive power, and percent of class are reported per person even on a joint filing where several funds and their controlling principal report overlapping shares — summing those percentages double-counts the same position. Coverage starts at 2024-12-18, when SEC replaced the legacy SC 13D / SC 13G text filings with this XML format; earlier stakes are readable but not parseable, and the response reports how many of them the issuer has. The full parsed set is materialized as df_ when a canvas is available, one row per reporting person, so it joins against the insider dataframes on issuer CIK and the 13F and NPORT-P dataframes on CUSIP — inspect it with secedgar_dataframe_describe, then analyze it with secedgar_dataframe_query.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"issuer": "<issuer>"
},
"name": "secedgar_get_beneficial_owners"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Number of successfully parsed filings naming the requested issuer to return, newest first. Other-issuer schedules and failed documents do not consume this limit; at most 50 documents are examined. Default 10. Capped at 20: a larger value, up to 1000, returns what 20 returns. | |
| issuer | Yes | The company whose blockholders you want — a ticker ("AAPL"), a 10-digit CIK ("0000320193"), or a company name. This is the subject company of the schedule, not the investor filing it; passing an investment manager here returns the schedules filed about that manager, which is almost always empty. | |
| form_kind | No | Which schedule to return. "13D" is the activist form, filed by a holder that may seek to influence control and carrying a stated purpose of transaction. "13G" is the passive form, available to institutions and holders under 20% that certify no control intent. "all" (default) returns both, newest first. | all |
| include_amendments | No | Whether to include amendments (SCHEDULE 13D/A, SCHEDULE 13G/A). Amendments carry the current position and are how an ongoing stake is tracked, so they are included by default. Set false to see only filings that opened a new position. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cap | No | Result limit or document ceiling that stopped scanning. | |
| error | No | Present when the call failed. Absent on success. | |
| shown | No | Number of filings returned. | |
| issuer | No | The issuer input, echoed. | |
| notice | No | Exclusions, document recovery, scan bounds, cut text, and dataframe guidance. | |
| dataset | No | Dataframe with one row per reporting person across parsed filings; joins insider dataframes on issuer_cik, and 13F and NPORT-P dataframes on cusip. Absent when canvas is unavailable or nothing parsed. | |
| filings | No | Blockholder filings, newest first, capped at limit. | |
| partial | No | True when filings_failed is nonempty, independently of truncation. | |
| form_kind | No | The schedule filter applied (default "all"). | |
| truncated | No | True when filings_not_examined > 0. | |
| issuer_cik | No | CIK of the resolved issuer, zero-padded to 10 digits. | |
| resolvedAs | No | How the input was read: a ticker spelling, former ticker, earlier holder, or entity-index match. | |
| issuer_name | No | EDGAR-conformed name of the resolved issuer. | |
| filings_failed | No | Failures in scan order; successes retained. | |
| filings_parsed | No | Matching parsed filings, capped by limit. | |
| filings_examined | No | Matches + exclusions + failures; at most 50 documents. | |
| filings_not_examined | No | Indexed schedules beyond the result limit or 50-document ceiling. | |
| structured_coverage_from | No | First date SEC required this XML format (YYYY-MM-DD); earlier filings cannot be parsed here. | |
| total_structured_filings | No | Indexed 13D/13G schedules matching form/amendment filters in the recent submissions window. | |
| filings_excluded_other_issuer | No | Schedules naming another issuer; no rows returned. | |
| legacy_filings_before_coverage | No | Legacy SC 13D / SC 13G filings (pre-2024-12-18) in the recent submissions window (last year or 1,000 filings), so a floor; find them with secedgar_search_filings. |