> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rangler.co/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.

```json theme={null}
{
  "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](/financials/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](/financials/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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.