Find Holders
secedgar_find_holdersFind which institutional managers reported holding an issuer, by searching 13F-HR information tables for one reporting quarter. This is the reverse direction of secedgar_get_institutional_holdings: that tool takes a manager and returns its portfolio, this one takes an issuer and returns its managers — pass a returned filer_cik plus the same quarter to read the actual position. Searching by cusip is the precise path, matching the identifier the information table itself carries; without it the issuer name is matched as a phrase against the filing text, which both over-matches (unrelated issuers sharing a word) and under-matches (managers writing the name differently), so prefer cusip whenever one is known. A CUSIP cannot be derived from a ticker here — read one off any 13F information table returned by secedgar_get_institutional_holdings. The returned list is unranked: the search index scores by text relevance, which carries no signal about position size, and no ordering by shares or market value is available without opening each filing. Managers holding under $100M in 13(f) securities are exempt from filing at all. When more managers match than fit inline, the full fetched set is staged as df_ — 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_find_holders"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cusip | No | The issuer's 9-character CUSIP (e.g. "037833100" for Apple common stock; foreign issuers use a CINS starting with a letter, e.g. "H1467J104"). The precise match key — information tables identify every position by CUSIP, so this avoids the name-phrase misses. Each share class has its own CUSIP, so a multi-class issuer needs one call per class. Read a CUSIP off the holdings returned by secedgar_get_institutional_holdings. | |
| limit | No | Filer rows returned inline. The full fetched set (up to 500 rows) is materialized as a dataframe when a canvas is available. Default 20. Capped at 100: a larger value, up to 1000, returns what 100 returns. | |
| issuer | Yes | The portfolio company whose holders you want — a ticker ("AAPL"), a 10-digit CIK ("0000320193"), or a company name. Without cusip, this resolves to the company's EDGAR-conformed name, and that name, minus a trailing qualifier such as \DE\ or /OH/, is phrase-matched against 13F information tables, so it must identify one company. With cusip supplied, it is used only to label the result. | |
| quarter | No | Reporting quarter to search, "YYYY-QN" (e.g. "2026-Q1"). Omit for the newest quarter whose 45-day filing deadline has passed — the applied quarter and its filing window are echoed in the response. A quarter still inside its deadline returns only the managers that filed early, so its set is incomplete until the deadline passes. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cap | No | The limit cap applied. | |
| error | No | Present when the call failed. Absent on success. | |
| shown | No | Number of filers shown inline. | |
| issuer | No | The issuer input, echoed. | |
| notice | No | Continuation, search coverage, shared names, empty results, and dataframe guidance. | |
| dataset | No | Fetched managers keyed by issuer and quarter for joins. Absent if inline fits, canvas is unavailable or staging fails. | |
| fetched | No | Filings retrieved, at most 500; equals total_filings when the window fit. | |
| holders | No | One page of filers, capped at limit; order says nothing about position size. | |
| quarter | No | Reporting quarter searched, "YYYY-QN": the requested one or the default. | |
| filed_to | No | End of the filing window searched (YYYY-MM-DD). | |
| ordering | No | How the holder list is ordered, and what that ordering does not mean. | |
| truncated | No | True when the inline holders list was capped. | |
| filed_from | No | Start of the filing window searched (YYYY-MM-DD). | |
| resolvedAs | No | How the input was read: a ticker spelling, former ticker, earlier holder, or entity-index match. | |
| search_key | No | The exact term searched — the CUSIP, or the quoted name minus any trailing qualifier. | |
| search_mode | No | "cusip" matches the information table's identifier; "name" phrase-matches filing text, looser both ways. | |
| total_filings | No | Matching documents in the filing window, including amendments; holders_in_quarter deduplicates managers and filters period. | |
| total_is_exact | No | False when total_filings is a lower bound (the index capped the count). | |
| holders_in_quarter | No | Distinct in-quarter managers in the fetched sample and dataframe; latest filing per CIK wins, other periods excluded. | |
| resolved_issuer_cik | No | CIK of the resolved issuer, zero-padded to 10 digits. Absent when cusip was supplied. | |
| resolved_issuer_name | No | EDGAR-conformed name the issuer resolved to. Absent when cusip was supplied. |