Get Material Events
secedgar_get_material_eventsRetrieve a company's 8-K filings with their item codes decoded, optionally filtered to specific items. 8-K item codes are how material events are actually scoped — 1.01 material agreements, 2.02 results of operations, 4.02 non-reliance on previously issued financials, 5.02 officer and director departures — and filtering by them is narrower than any form-level filter in secedgar_search_filings or secedgar_company_search, neither of which can see items. Each row carries the accession number and primary document for secedgar_get_filing; press releases usually ride as EX-99 exhibits rather than in the primary document. Two numbering regimes exist: filings from 2004-08-23 onward use the x.xx codes, earlier ones use single integers (12 was the old results-of-operations item, 9 the old Regulation FD item), and both are accepted as filters and decoded in the response. A date window reaches filings older than the recent submissions window by reading every archive page it overlaps, up to 10; without one, the scan reads back only as far as it needs to fill limit with filings passing the items filter, within the same 10 pages. Every scanned filing that passes the filter is materialized as df_ for item-distribution analysis over time (pass a date window to cover a longer span) — 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": {
"company": "<company>"
},
"name": "secedgar_get_material_events"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| items | No | Item codes to filter to; a filing matches when it reports any of them. Omit to return every 8-K. Current-regime codes are dotted ("2.02"), pre-2004-08-23 codes are bare integers ("12"), and the two vocabularies do not overlap — filtering on "2.02" alone returns nothing from a pre-2004 window, so pair them ("2.02", "12") when the window spans the changeover. Full decode table: the secedgar://filing-types resource. | |
| limit | No | Filings returned inline, newest first. Every scanned filing that passes the filter is materialized as a dataframe when there are more than this and a canvas is available. Default 20. Capped at 100: a larger value, up to 1000, returns what 100 returns. | |
| company | Yes | Company ticker symbol (e.g. "AAPL"), name (e.g. "Apple"), or CIK number (e.g. "320193"). Ticker is the exact lookup; name search matches current and former names. | |
| 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 8-K filings that predate the recent window (the last year or 1,000 filings of every form, whichever holds more). | |
| 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. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cap | No | The limit cap applied. | |
| cik | No | Resolved CIK, zero-padded to 10 digits. | |
| error | No | Present when the call failed. Absent on success. | |
| shown | No | Number of filings shown inline. | |
| notice | No | Why nothing matched (an empty date window, or an items filter that excluded everything), and, when the page cap left pages unread short of limit, how far the scan reached and a window going further. | |
| dataset | No | Dataframe of every scanned 8-K passing the filter; item_codes is comma-separated (unnest(string_split(item_codes, ','))). Absent when the result fits inline, canvas is unavailable, or staging failed. | |
| filings | No | Matching filings, newest first, capped at limit. | |
| truncated | No | True when the inline filings list was capped. | |
| resolvedAs | No | How the input was read: a ticker spelling, former ticker, earlier holder, or entity-index match. | |
| company_name | No | SEC-conformed company name. | |
| items_filter | No | The item codes filtered on, echoed. Absent when no filter was applied. | |
| total_matched | No | Filings matching every filter across the scan; can exceed limit. | |
| total_8k_scanned | No | 8-K filings in the date window before the items filter; compare total_matched. | |
| item_distribution | No | Scanned 8-K filings per item code, before the items filter. Empty when none were scanned. | |
| history_scanned_through | No | Oldest filing date the scan examined (YYYY-MM-DD). Absent when nothing was scanned. | |
| older_filings_unexamined | No | Present with history_scanned_through: true when filings older than it went unexamined, so older 8-Ks may exist; false when the scan reached the company's first filing. |