DATA & COVERAGE
Financial metric definitions
Definitions, period types and caveats for the seven mapped SEC financial metrics.
Income statement
- revenue — revenue reported for a period, selected from a small set of mapped US GAAP revenue tags. Companies can report revenue using different concepts; check the source tag.
- net_income — reported net income or loss for a period. A loss can be negative; this is not automatically a per-share measure.
Balance sheet
- total_assets — assets reported at a point in time.
- total_liabilities — liabilities reported at a point in time; this is not the same as total debt.
- cash — cash and cash equivalents at carrying value reported at a point in time; restricted cash and investments are not automatically included.
Cash flow statement
- operating_cash_flow — net cash provided by or used in operating activities over a period.
- capital_expenditure — the mapped payments to acquire property, plant and equipment over a period. This is a reported payment amount, not a comprehensive measure of every investment and not automatically a negative cash-flow figure.
Units, signs and sources
The mapped definitions currently use USD. Values are returned as decimal strings, preserving the filer’s reported sign; parse them with a decimal-safe type when accuracy matters. The response includes a source tag, filing accession and source URL. Mapping version 1.0 is used, including for as-of queries.
A reported amount may be missing, ambiguous or not covered by the selected mapping. Confirm the meaning against the filing, including its notes and accounting policies. Query /v1/metrics for the currently exposed definitions.