Home / Markets / Learn / companyfacts
LEARN · DATA
The companyfacts endpoint provides the Securities and Exchange Commission's comprehensive JSON data dump containing all tagged XBRL concepts for a specific Central Index Key. It acts as a standardized time series for historical revenue, earnings per share, and related fundamental metrics. Analysts use this repository to pull raw corporate data directly from official regulatory filings.
Accessing standardized XBRL data ensures that fundamental metrics are derived directly from primary regulatory filings rather than relying on potentially inconsistent third-party vendor aggregations. This dataset serves as the foundational source of truth for calculations such as trailing price-to-earnings ratios. When official XBRL data is missing or incomplete, automated systems halt metric generation rather than guessing missing financial values. This strict adherence to verified filings protects analytical pipelines from propagation errors and ensures consistent historical comparisons across different reporting periods.
Reviewing companyfacts involves navigating structured JSON trees where each financial concept corresponds to specific reporting tags and fiscal periods. Analysts parse these nodes to track multi-year trends in assets, liabilities, and net income without manual transcription errors. Pay close attention to unit definitions and scaling factors embedded within each XBRL tag to avoid order-of-magnitude calculation mistakes.
The companyfacts endpoint does not provide qualitative management commentary, forward-looking guidance notes, or unaudited press release figures issued prior to official regulatory filing submission. It also fails to capture preliminary earnings announcements released via Form 8-K before the corresponding XBRL data tags are fully processed and published.
`npm run market:fundamentals` caches companyfacts for S&P 100. Stock pages and EQS read the cache.