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

# Reported and calculated values

> Determine how every standardized value was produced and trace it back to its filing source.

Use `metric_origins` to classify each returned metric value. Do not infer origin from the metric name or from the catalog's general definition.

## Metric origins

| Origin | Meaning |
| - | - |
| `reported` | The standardized value is linked to a line item reported in a filing. |
| `derived_line_item` | Rangler calculated the line item from other accounting values in the same logical period. |
| `derived_period` | The period or value was assembled from other periods, such as a trailing-twelve-month series. |
| `unknown` | The available source details cannot safely establish one of the preceding categories. |

Ratios are derived by definition. Their formulas and dependencies live in the versioned metric catalog. `is_derived_period` describes the period itself and is separate from a metric's origin.

```json theme={null}
{
  "metrics": {
    "revenue": 125000000000,
    "net_change_in_cash": 9200000000
  },
  "metric_origins": {
    "revenue": "reported",
    "net_change_in_cash": "derived_line_item"
  }
}
```

## Source references

Set `includeSources=true` to return a compact `sources` map keyed like `metrics`. A reported value can include `cell_id`, `filing_id`, and `page`. A calculated value can also include a `derivation` with its operands.

For a derived value, inspect its derivation and operand references rather than presenting one operand as though it were the reported source of the derived result.

## Render evidence

Use source endpoints only after selecting a metric's returned source identifiers:

```http theme={null}
GET /v1/companies/{company_id}/statement-cells/{cell_id}/source
GET /v1/companies/{company_id}/statement-cells/{cell_id}/geometry
GET /v1/companies/{company_id}/statement-table-values/{value_id}/source
```

Source renders return `image/png`. Geometry returns coordinates for highlighting the value in the filing page.

## Restatements

`is_restated=true` means at least one value in the returned period came from a later filing's restated comparative. `restated_metrics` identifies exactly which metrics were restated. Do not label every value in the period as restated without checking that list.


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