npi-registry__company_facts
TYPED, DETERMINISTIC financial facts for a US public company for an EXPLICITLY NAMED reporting period, "Apple revenue for fiscal 2023", "Walmart net income FY2026 Q3", "Microsoft cash at the end of fiscal 2024". PREFER OVER entity_profile / get_company_financials whenever the period matters: those answer "the most recent figures" and will happily hand back FY2025 when you asked about FY2019, and neither separates a discrete quarter from a year-to-date figure. This one refuses instead, it NEVER s
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": {
"period": {
"type": "annual",
"fiscal_year": 2023
},
"company": "AAPL",
"attribute": "revenue"
},
"name": "npi-registry__company_facts"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| as_of | No | Past ISO timestamp with timezone. Replay the latest answer actually recorded by that instant; no invented history or live fallback. | |
| basis | No | Only "consolidated" in v1. Segment and product-level figures are XBRL-dimensioned and are not reachable through this contract at any concept. | |
| period | Yes | The reporting period, stated explicitly. There is no default and no "latest", that is the point of this tool. | |
| company | Yes | Ticker ("AAPL"), 10-digit CIK ("0000320193"), or company name. A name that matches two filers equally well returns status "ambiguous" with both named rather than guessing, pass a ticker or CIK to be certain. | |
| max_age | No | Maximum age in seconds of the upstream publication, not our fetch. Older or undated facts are withheld. | |
| attribute | Yes | Which figure. "revenue" = total consolidated revenue; "net_income" = net income (loss); "cash" = cash and cash equivalents at the period end; "gross_profit"; "operating_income"; "eps_diluted" (diluted EPS, unit USD/shares, never derived or summed); "capex" (cash paid for PP&E); "operating_cash_flow" (net cash from operating activities); "long_term_debt" (the noncurrent balance-sheet line where the filer tags it, else total long-term debt, `fact.measure` says which); "shares_outstanding" (dei cover-page common shares, unit "shares", as of the COVER DATE rather than the period end). | |
| freshness | No | cached (default) permits an eligible stored answer; fresh requires an upstream refresh and never silently falls back to stale data. | |
| restatement | No | Default "as_amended", the latest filed figure for the period, with everything it superseded listed. "as_originally_reported" takes the first filing instead. | |
| exclude_publishers | No | Publisher ids forbidden for fact retrieval: sec, fmp, alphavantage. Case and surrounding whitespace are normalized; unknown ids are refused. Excluding sec currently leaves no eligible fact source and returns unavailable/sources_excluded with the selection reasons. Identity and fiscal-calendar lookups may still use SEC; no excluded financial concept is fetched. |