Financial Actuals & Estimates
Each financial document in financial_documents carries two optional metric objects: actual for reported figures and estimate for analyst consensus forecasts. Either may be null — always guard with .get() or optional chaining.
Monetary values in
actual and estimate are in millions of the stated currency. Per-share values (eps, dps) are not scaled.Actual metrics
Present when reported figures have been processed. null for future or estimate-only periods.
JSON
{
"currency": "USD",
"net_sales": 284.5,
"ebitda": -108.2,
"eps": -0.43,
"dps": null
}FieldTypeUnitsDescription
currencystring—ISO 4217. E.g. "USD", "EUR", "GBP".net_salesnumber | nullmillionsNet revenue / total revenue.ebitdanumber | nullmillionsEBITDA for the period.epsnumber | nullper shareEarnings per share.dpsnumber | nullper shareDividends per share. null if not declared.Estimate metrics
Analyst consensus forecast figures. May co-exist alongside actual for comparison, or appear alone for future periods where actuals are not yet reported.
JSON
{
"currency": "USD",
"revenue": 310.0,
"ebitda": -95.0,
"ebit": -120.0,
"netIncome": -180.0,
"sgaExpense": 45.0,
"eps": -0.38
}FieldTypeUnitsDescription
currencystring—ISO 4217 currency code.revenuenumber | nullmillionsConsensus revenue estimate.ebitdanumber | nullmillionsConsensus EBITDA estimate.ebitnumber | nullmillionsConsensus EBIT estimate.netIncomenumber | nullmillionsConsensus net income estimate.sgaExpensenumber | nullmillionsConsensus SG&A expense estimate.epsnumber | nullper shareConsensus earnings per share estimate.