List Filings
get_filingsQuery SEC filings by form type, date range, CIK and/or 8-K item.
Returns filings newest first. Each filing's content_object lists its documents (sequence 1 is the primary); read one with get_document(cik, accession_number, filename). Cite beatandraise_base_url + filename; the filing's source has a ready-made citation. 8-Ks carry their items ("2.02 Results of Operations..."). R*.htm files are XBRL table pages (list_filing_tables names them).
An 8-K carries a headline when its press release has one: found by rules, so use it to choose which 8-K to read, not as a quotation (verify_quote first). No headline says nothing about the filing. An 8-K with only Item 9.01 and no headline files exhibits only (exhibits_only lists them) and is rarely news.
Args: form: SEC form type (e.g. "10-K", "10-Q", "8-K", "4", "13F-HR", "S-1"), or several comma-separated in one call (up to 20), e.g. "N-CSR,N-CSRS,N-CSR/A,N-CSRS/A" or "10-K,10-K/A". Amendments are their own form types, so name them to include them. cik: Company CIK (e.g. "0000320193" or "320193") from_date: Start date inclusive (YYYY-MM-DD). Without cik, defaults to 30 days before to_date (or today); pass it to reach older filings. to_date: End date inclusive (YYYY-MM-DD) limit: Max results (1-100, default 100; at most 25 with include_item_text). For more, page with offset offset: Pagination offset item: Only 8-Ks reporting this item, by its number as the 8-K header states it, e.g. "5.02" (departure or election of directors or officers, officers' pay), "1.01" (material agreement), "2.01" (acquisition or disposal), "4.01" (auditor change), "5.07" (shareholder vote); several comma-separated match any ("1.01,2.01"). Defaults form to "8-K,8-K/A". Numbered since 2004-08-23. Use it instead of reading 8-Ks one by one. include_item_text: With item, also return each filing's text of that item (item_texts, with a highlight_url), so a screen across companies is one call: whether a 5.02 is a director, a CEO or a pay plan is in the text. item_text: Items whose text to return with each 10-K, 10-Q or 8-K, by number or name, up to 5 comma-separated ("MD&A", "1A", "Risk Factors", "5.02"). With form="10-Q" and a cik, "MD&A" gives the last several MD&As in one call. item_text_chars: Characters per Item, 1,000-100,000 (default 10,000); a page carries at most 500,000, so limit is lowered to fit.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "get_filings"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cik | No | ||
| form | No | ||
| item | No | ||
| limit | No | ||
| offset | No | ||
| to_date | No | ||
| from_date | No | ||
| item_text | No | ||
| item_text_chars | No | ||
| include_item_text | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||