News from 8-K filings
newsReturn the newest 8-K filings across all companies (or one), each with its items, event types (earnings, acquisition_disposition, leadership_change, restatement, bankruptcy, agreement...), a headline and an importance from 1 to 5. Use importance_min 4 for top stories (earnings, M&A, impairments, auditor changes, restatements, bankruptcies). Importance is FinancialMD's rule by 8-K item number; this is a filing-based feed, not wire news, so follow source_url for the text. Use it for what was filed recently across the market or by one company.
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,
"importance_min": 4
},
"name": "news"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | Accepted on or before (YYYY-MM-DD). | |
| from | No | Accepted on or after (YYYY-MM-DD). | |
| 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 200). | |
| cursor | No | Opaque cursor from a previous page (data.next_cursor). | |
| company | No | Optional: one company. 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, bankruptcy, impairment, auditor_change...). | |
| importance_min | No | Only filings whose highest item is at least this important (5 critical, 4 major, 3 notable, 2 routine, 1 exhibits only). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | No | { items: [{ company, accession, form, filed, accepted_at, importance, headline, event_types, items: [{ item, title, event_type, importance }], source_url }], 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. |