Secedgar Company Search
secedgar_company_searchFind companies and retrieve entity info with optional recent filings. Entry point for most EDGAR workflows — resolves tickers, names, or CIKs to entity details, with accession numbers in the result feeding secedgar_get_filing for document content. A name SEC's ticker file misses is looked up in EDGAR's entity index of every filer, then in 10-K subsidiaries exhibits, whose filers the not-found error names as possible parents. When a date or form filter carries the scan past the recent submissions window, the full filtered filing history is also 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": {
"query": "<query>"
},
"name": "secedgar_company_search"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| forms | No | Filter filings to specific form types (e.g., ["10-K", "10-Q", "8-K"]), matched exactly (case-insensitive) — list an amendment such as "10-K/A" to include it. Without this, returns all form types. | |
| query | Yes | Company ticker symbol (e.g., "AAPL", "VOO"), name (e.g., "Apple"), or CIK number (e.g., "320193"). Ticker is the fastest lookup and works for equities, ETFs, and mutual funds; a multi-class share ticker resolves in either form ("BRK-B" or "BRK.B"), and an uppercase ticker also resolves as market-data feeds write it: venue-coded ("UEC.N"), a preferred class run together ("CFGPH"), or a class root ("GLOP"). Name search matches current and former names, preferring a name the query matches exactly over one it only starts or appears in, and never matching from inside a word ("SY Bancorp" does not find "Embassy Bancorp"); an exact or starts-with match ignores commas, periods, apostrophes, extra spaces, and the spaces between single initials ("QXO Inc" finds "QXO, Inc."; "U.S. Bancorp" finds "US BANCORP"; "Macys" finds "Macy's, Inc."; "JM Smucker" finds "J M SMUCKER Co"). The corporate suffix (Inc, Corp, Co, Ltd, PLC, LLC, LP, N.V., S.A., AG, SE) can be left off ("Apple" finds "Apple Inc."; "Rio Tinto" lists both the Ltd and the PLC) or spelled out ("Beacon Financial Corporation" finds "Beacon Financial Corp"), but a suffix you include must match — Corp, Inc, Co, and Ltd stay distinct from each other, since separate registrants differ only by which one they use. A name with its words in another order also matches when nothing else does ("Charles Schwab" finds "SCHWAB CHARLES CORP"). A former ticker resolves to the company that last held it ("AMRK" finds Gold.com). A name SEC's ticker file misses is looked up in EDGAR's entity index, which also holds filers with no ticker ("Exxon Mobil" finds EXXON MOBIL CORP); a private company found only in a 10-K's subsidiaries exhibit fails as not found, naming the filer of that exhibit as its possible parent. | |
| filed_after | No | Only include filings filed on or after this date (YYYY-MM-DD). A date filter routes the scan into the older submissions archive pages, so it reaches filings that predate the recent window — the last year or 1,000 filings, whichever holds more (e.g. a company's 2005 10-K). | |
| filed_before | No | Only include filings filed on or before this date (YYYY-MM-DD). Use alone or with filed_after; together they bound the archive-page scan. | |
| filing_limit | No | Maximum number of filings to return in the inline list; when more match, the notice names where the rest are. Capped at 50: a larger value, up to 1000, returns what 50 returns. | |
| include_filings | No | Include recent filings in the response. Set to false for entity-info-only lookups. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cap | No | The inline limit applied: `filing_limit`, at most 50. | |
| cik | No | Central Index Key, zero-padded to 10 digits. | |
| sic | No | SIC industry code. | |
| name | No | SEC-conformed company name. | |
| error | No | Present when the call failed. Absent on success. | |
| shown | No | Number of filings returned inline. | |
| notice | No | Guidance when no filings matched the forms filter, or when the inline list withheld some: the dataframe, a larger filing_limit, or a secedgar_search_filings call for the rest. | |
| dataset | No | Dataframe of the full filtered history, staged only when the scan read archive pages and the history outgrows the inline list. | |
| filings | No | Recent filings, filtered by forms if specified. | |
| tickers | No | Associated ticker symbols. | |
| class_id | No | SEC fund class ID (e.g. "C000092055"), present alongside series_id. | |
| exchanges | No | Exchanges where listed. | |
| series_id | No | SEC fund series ID (e.g. "S000002839"), when the query resolved via a fund ticker (ETF or mutual fund). | |
| truncated | No | True when more filings matched than the inline list holds. | |
| resolvedAs | No | How the input was read: a ticker spelling, former ticker, earlier holder, or entity-index match. | |
| total_filings | No | Filings matching the filter across everything scanned; can exceed the inline list. | |
| fiscal_year_end | No | Fiscal year end (MM-DD, e.g. "09-26"). Absent when SEC records none (e.g., private or pre-IPO entities). | |
| sic_description | No | Human-readable SIC description. | |
| state_of_incorporation | No | State of incorporation (US two-letter code, e.g. "DE"). Absent for many foreign filers and individuals. | |
| history_scanned_through | No | Oldest filing date the scan examined (YYYY-MM-DD), reaching past the recent window only for a date filter or an under-filled forms filter. Absent when nothing was scanned. | |
| older_filings_unexamined | No | Present with history_scanned_through: true when filings older than it went unexamined; false when the scan reached the company's first filing. |