Company-reported metrics (adjusted and operating)
company_kpisReturn the metrics a company reports in its own earnings releases and reports: adjusted (non-GAAP) measures such as adjusted EBITDA or adjusted EPS, and operating KPIs such as segment or product sales. Each value carries the filer's row label, confidence (high: printed identically in two or more places; medium: printed once) and a proof id; proof_get on it returns the exact citation: accession, document, table, row and value index, character span, the raw printed text and the GAAP reconciliation table. Adjusted metrics are the company's own definitions: say "as reported by the company (non-GAAP)", never call them GAAP and never compare them across companies. Values two documents print differently are withheld and not returned (data.withheld counts them). data.metrics lists the company's metrics; filter with metric, kind, period_type, from and to. Percent metrics are percent points. Use it when the question is about a non-GAAP figure or an operating metric the standardized statements do not carry.
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": {
"kind": "adjusted",
"limit": 10,
"company": "ticker:MSFT"
},
"name": "company_kpis"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | Last period end, inclusive (YYYY-MM-DD). | |
| from | No | First period end, inclusive (YYYY-MM-DD). | |
| kind | No | adjusted: non-GAAP measures; operating: operating statistics. | |
| 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 50, at most 1000). | |
| cursor | No | Opaque cursor from a previous page (data.next_cursor). | |
| metric | No | Only this metric slug (for example adjusted_ebitda); data.metrics lists them. | |
| 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. | |
| period_type | No | Only this period type. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | No | { items: [{ metric, reported_label, label, period_type, period_start, period_end, value, confidence, confidence_label, corroborated_by, reconciliation_anchor }], next_cursor, metrics, withheld, 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. |