Financial facts
GET /v1/companies/{companyId}/financials?metric=net_income&limit=10&offset=0Returns accepted, reviewed financial facts from current processed document versions. Results are ordered by reporting-period end, newest first.
Parameters
Section titled “Parameters”| Parameter | Type | Required | Rules |
|---|---|---|---|
companyId |
UUID | Yes | Path |
metric |
string | Yes | One supported metric below |
limit |
integer | No | 1–20; default 10 |
offset |
integer | No | 0–100; default 0 |
Supported metrics
Section titled “Supported metrics”| Income & returns | Balance sheet | Cash flow & distributions |
|---|---|---|
revenue |
assets |
operating_cash_flow |
operating_income |
liabilities |
investing_cash_flow |
net_income |
equity |
financing_cash_flow |
eps |
cash |
capital_expenditure |
profit_margin |
debt |
dividend_per_share |
return_on_assets |
||
return_on_equity |
Support for a metric name does not guarantee a fact exists for every company or period.
Fact fields
Section titled “Fact fields”| Field | Meaning |
|---|---|
id, metric, metric_label |
Fact identity and measure |
value |
Decimal string in base units |
reported_value |
Representation captured from the source |
unit_multiplier |
Source-unit provenance, as a string |
currency |
Reported currency when applicable |
period_start, period_end, period_type, fiscal_year |
Reporting period |
entity_scope |
Reporting entity, such as group or company |
restated |
Whether the fact is marked as restated |
reviewed_at |
Review timestamp |
document_id, version_id, page_number |
Source document, current version and page |
source_title, source_url, link |
Source title, original URL and Fisk document link |
Displaying values
Section titled “Displaying values”value is already normalized to base units. A value of "1200000000" with currency TZS means TZS 1.2 billion. If unit_multiplier is "1000000", do not multiply the value again.
Use a decimal library for financial arithmetic. JavaScript numbers may lose precision for large decimal values. Choose formatting separately from calculation.
Do not infer a percentage scale or currency for a ratio from its name alone. Preserve metric_label, reported_value and source context, and confirm interpretation before combining unlike measures.
Comparing periods
Section titled “Comparing periods”Compare facts only when metric definition, reporting period, currency and entity scope align. More than one accepted fact can describe different scopes or source definitions.
An empty array means no matching reviewed fact is available. Render an unavailable state rather than a zero, estimated result or growth percentage.
For citation and freshness guidance, see sources, units and freshness.