8-K events
company_eventsReturn the 8-K filings of a company, newest first, each with the items the filer selected (2.02 results, 5.02 officer changes, 1.01 agreements, 2.01 acquisitions, 4.02 non-reliance...) classified by event_type, with a headline and an importance from 1 to 5 (importance_min 4 keeps the major ones). A filing-based event feed, not wire news; for all companies use news; follow source_url for the text. Use it when asked what material events one company disclosed.
Example tool call
This call uses example arguments supplied in the tool’s input schema.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"limit": 10,
"company": "ticker:AAPL"
},
"name": "company_events"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| as_of | No | Knowledge date or timestamp (YYYY-MM-DD or RFC 3339). The answer is what FinancialMD knew at that instant: only facts whose known interval contains as_of. Omit for the current view. | |
| limit | No | Maximum number of periods or items to return (default 20, at most 500). | |
| cursor | No | Opaque cursor from a previous page (data.next_cursor). | |
| company | Yes | Company identifier: a FinancialMD id ("fmd_01H..."), an SEC CIK ("cik:320193"), or a ticker ("ticker:AAPL", optionally with the MIC "ticker:AAPL.XNAS"). A bare ticker like "AAPL" is accepted and sent as ticker:AAPL. An issuer on an EU or UK regulated market that does not file with the SEC has no CIK: pass its LEI ("lei:IOG4E947OATN0KJYSD45") or its fmd_ id. | |
| event_type | No | Only filings with an item of this type (earnings, leadership_change, agreement, acquisition_disposition, restatement...). | |
| importance_min | No | Only filings whose highest item is at least this important. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | No | { items: [{ accession, form, filed, accepted_at, report_date, source_url, importance, headline, event_types, items: [{ item, title, event_type, importance }] }], next_cursor, note } | |
| meta | No | Request metadata: request_id, as_of, company resolution, coverage, pipeline_version, licence, terms, proof_base. | |
| error | No | Present only on isError results: the API error code and message plus remedy hints. |