Sec Get Company Facts
sec_get_company_factsGet XBRL financial facts for a company by CIK number, ticker, or company name. Returns latest_annual — revenue, net income, operating income, total assets, liabilities, equity, cash, EPS and shares for the most recent fiscal year (10-K), resolved to whichever XBRL concept the filer currently reports under — plus per-concept detail with the fiscal year and period end on every figure. Concepts the filer has retired (e.g. a pre-ASC-606 Revenues tag) are kept for history but flagged stale and sorted last. Response field matched_by says whether the company was matched by ticker or by company name.
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": {
"cik": "320193"
},
"name": "sec_get_company_facts"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cik | Yes | Company CIK ("320193"), ticker ("AAPL"), or name ("Apple") — ticker/name are auto-resolved to a CIK |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cik | Yes | Company CIK number | |
| year_note | No | How `year` is derived | |
| matched_by | No | How the company was matched: ticker, cik or company_name | |
| company_name | Yes | Official company name | |
| latest_annual | Yes | Canonical line items for the most recent fiscal year — revenue, net_income, operating_income, gross_profit, total_assets, total_liabilities, stockholders_equity, cash_and_equivalents, eps_basic, eps_diluted, shares_outstanding, research_and_development — each resolved to whichever concept the filer currently reports under; null when the filer reports no current value | |
| key_financials | Yes | Per-concept detail. Current concepts first, retired (stale) concepts last — a stale concept is kept because a historical series still needs it, never silently dropped | |
| stale_concepts | Yes | Concepts the filer has stopped reporting; present in key_financials flagged stale, never used in latest_annual | |
| latest_period_end | No | Period end of that most recent annual report (YYYY-MM-DD) | |
| available_concepts | Yes | Total number of US-GAAP financial concepts available for this company | |
| latest_fiscal_year | No | Fiscal year of the filer's most recent annual report across every concept examined |