list_filings
Which SEC filings exist for a company, with accession numbers.
What it does
Lists a company's filings from the SEC EDGAR submissions index, newest first, each with its accession number -- the id every other filing tool takes. latest_annual names the report the other tools default to. An empty list is NEVER bare: reason distinguishes "no SEC filer is mapped to this symbol" from "EDGAR gave us something we could not read", and adr_symbol names the US-listed ADR to retry against where one exists. Read reason before telling anyone a company files nothing.
list_filings is on the free tier. A free account gets 12 agent calls per 16 hours and this is one of them; Pro is uncounted. The website's own screening allowance is counted separately.
Arguments, returns and a worked call
Everything below is generated from the same registry entry the MCP server and /openapi.json are generated from, so this page cannot name an argument that does not exist. The two examples are the same call, once over each transport.
list_filings
FreeLists a company's filings from the SEC EDGAR submissions index, newest first, each with its accession number -- the id every other filing tool takes. `latest_annual` names the report the other tools default to. An empty list is NEVER bare: `reason` distinguishes "no SEC filer is mapped to this symbol" from "EDGAR gave us something we could not read", and `adr_symbol` names the US-listed ADR to retry against where one exists. Read `reason` before telling anyone a company files nothing.
Arguments
symbol string, required — The ticker as Crush The Market spells it. London listings carry a `.L` suffix.
form string, optional — Return only this form, matched exactly: 10-K, 10-Q, 8-K, 20-F, 40-F.
limit number, optional — How many filings to return, 1-100, newest first. Defaults to 20. The full match count is always in `total`.
Returns
symbol, count, total, filings, reason, reason_note, adr_symbol, latest_annual, note, error, as_of, source, disclaimer
> curl -s https://crushthemarket.com/api/v1/list_filings \ -H "Authorization: Bearer $CTM_KEY" \ -H 'Content-Type: application/json' \ -d '{"symbol":"AAPL","form":"10-K"}'{ "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "list_filings", "arguments": { "symbol": "AAPL", "form": "10-K" } }}Can answer
bad_request — `symbol` is missing or empty.
Calling list_filings
- 1.Register free — an email address, no card — then create a key under API Keys on your account page. Your email address has to be verified first, and the key is shown once.
- 2.Using a chat client that speaks MCP? The MCP guide is one paste. Anything else takes bearer auth, the error codes and the limits from the REST guide.
- 3.Make the call above with your own key in it.
Every successful response carries as_of, source, a quota block saying how much of the allowance is left, and the same disclaimer this page ends on.
More for agents
Data, not advice. Do your own diligence.