Financial response model

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:971d8ba4d993db36b5e02c0870a250b7595ac59569701f057fb3a2724be57e30",
  "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. Metric definitions are optional in each response. The ticker route defaults include_metadata=false; use catalog_version with the financial metric catalog when you need definitions without making every company response larger.

Missing data

Missing values are null or absent. They are never formatted placeholders such as —. Absence does not mean zero.

Overview

Getting started

Workflows

Financial data

Integration

Reference

Company and scope

Period identity

Metric groups

Missing data

​Company and scope

​Period identity

​Metric groups

​Missing data

Company and scope

Period identity

Metric groups

Missing data