Financial response model
Understand issuer identity, fiscal periods, standardized metrics, ratios, metadata, and filing sources in statement responses.
A standardized financial response identifies the matched company and reporting scope once, then returns reported and calculated periods in groups of named values. This excerpt was captured from a successful selective request for Access Holdings; it uses actual response values rather than placeholder numbers.
{
"company_id": "efa534f5-3b01-4f12-a33b-3c797b05beee",
"company": {
"id": "efa534f5-3b01-4f12-a33b-3c797b05beee",
"name": "Access Holdings Plc",
"ticker": "ACCESSCORP",
"exchange": "NGX",
"country_code": "NG"
},
"scope": "consolidated",
"scope_label": "Group",
"selected_subject": null,
"catalog_version": "sha256:3cc5f5800e5c13fe45a636979d7e5c3fd39e444d7e3d24adfa62c0275f607a95",
"reported_currency": "NGN",
"display_currency": "NGN",
"periods": [
{
"period_id": "fy_2025-12-31",
"period_end_date": "2025-12-31",
"calendar_year": 2025,
"calendar_quarter": 4,
"fiscal_year": 2025,
"fiscal_quarter": null,
"reporting_period": "FY 2025",
"period_type": "FY",
"duration_months": 12,
"is_derived_period": false,
"is_restated": false,
"reported_currency": "NGN",
"display_currency": "NGN",
"metrics": {
"profit_after_tax": 743045000000.0,
"net_interest_income": 1356891000000.0,
"interest_income": 3546335000000.0,
"operating_cash_flow": 886217000000.0
},
"metric_origins": {
"interest_income": "derived_line_item",
"net_interest_income": "reported",
"operating_cash_flow": "reported",
"profit_after_tax": "reported"
},
"ratios": {},
"sources": {
"profit_after_tax": {
"cell_id": "c6955b10-1531-51fd-ae30-bba80f90e2a7",
"filing_id": "58a5c0c4-9955-4292-85ed-0da998dae339",
"page": 86
}
}
}
],
"trailing_periods": []
}The example is abbreviated to one source reference. An empty ratios map means the selected ratio was unavailable for that response; it does not mean zero. Follow the generated API schema for nullable and optional fields, and see Financial API workflows for the complete request that produced this shape.
Company and scope
company is the issuer matched by Rangler. scope, scope_label, and selected_subject identify whether the response covers the group, company, bank, or another reporting subject. available_scopes lists the valid alternatives found in the relevant statements.
Period identity
| Field | Meaning |
|---|---|
period_id | Stable identifier within the selected company and scope. |
period_end_date | Statement end date. |
calendar_year, calendar_quarter | Calendar placement of the end date. |
fiscal_year, fiscal_quarter | Issuer fiscal-period placement when known. |
duration_months | Covered duration for flow metrics. |
is_derived_period | Whether the period itself was assembled, such as trailing twelve months. |
is_restated | Whether at least one returned metric is a restated comparative. |
restated_metrics | Exact metric keys sourced from a restated comparative. |
Do not infer fiscal year or duration from a display label. Use the typed period fields.
Metric groups
metrics, metric_origins, ratios, and sources use the standard metric name as their key. Rangler may add new standardized metrics without changing the overall response format. Clients should ignore unknown keys and select the keys they understand.
Metadata maps are optional payload conveniences. The ticker route defaults include_metadata=false; resolve catalog_version through Metric definitions and formulas for a smaller, cacheable integration.
Missing data
Missing values are null or absent. They are never formatted placeholders such as —. Absence does not mean zero.
Query financial statements
Select issuers, reporting scopes, periods, metrics, ratios, currency, metadata, and filing sources without downloading an entire company history.
Units and currency
Interpret monetary values, percentages, ratios, per-share metrics, share counts, and display-currency conversion correctly.