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

# Resilience Indicators

> The indicator-level explainability layer under the country resilience score — normalized values, runtime weights, contributions reconciled per dimension, observation age, and source provenance.

## Purpose

[The country resilience index](/docs/methodology/country-resilience-index) publishes one score per country. This route publishes the arithmetic behind it: all 72 registered indicators, what each contributed, and where each number came from.

It exists to make a score auditable. If a country's resilience moved, this is the endpoint that says which indicator moved and by how much.

Served from `GET /api/resilience/v1/get-resilience-indicators?countryCode=<ISO2>` and MCP `get_resilience_indicators`. Both require a Pro subscription. There is no dashboard surface — this is an API and agent endpoint.

## Per indicator

Each of the 72 rows carries:

| Field              | Meaning                                                                                                                                  |
| ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------- |
| Normalized score   | The indicator on the engine's common scale                                                                                               |
| State              | `observed`, `imputed`, `missing`, `fallback`, `not-applicable`, `source-failure`, `inactive`, or `retired`                               |
| Runtime weight     | The weight actually applied on this run, not the registry default                                                                        |
| Contribution       | The indicator's share of its dimension, reconciled so the dimension's contributions sum correctly                                        |
| Availability flags | `normalizedScoreAvailable`, `runtimeWeightAvailable`, and `scoringWeightShareAvailable` decide whether the matching numeric fields apply |
| Observation age    | How old the underlying observation is                                                                                                    |
| Source provenance  | Which upstream published it                                                                                                              |

Weights are served as applied rather than as configured because the engine renormalizes when an indicator is unavailable for a country. Reading the registry default would misattribute the score.

## Indicator states

`observed` and `imputed` are only two possible states. `missing` means no usable observation resolved, `fallback` means a lower-confidence substitute was used, `not-applicable` is structural, `source-failure` is an upstream or seed failure, and `inactive` or `retired` marks an indicator outside the active scoring path. An imputed or fallback indicator can still be a real part of the score, but it is not a measurement. Read `state` and the availability flags before any numeric field.

## Raw values and licensing

Raw source values are included **only where the upstream license permits redistribution**. Elsewhere the normalized score and the provenance are served without the underlying number.

That absence is a licensing boundary, not missing data — the engine has the value and used it; WorldMonitor may not republish it. The per-source terms are recorded in [Resilience indicator licensing](/docs/methodology/resilience-indicator-licensing).

## Reconciliation

Contributions are reconciled to each dimension rather than reported as raw products. A caller can sum the contributions within a dimension and get the dimension's score; summing across dimensions with their dimension weights gives the country score. Values that did not reconcile are not silently rounded into place — the indicator reports its state instead.

## Related

* [Pro Intelligence Suite](/docs/pro-intelligence-suite)
* [Country resilience index](/docs/methodology/country-resilience-index) — the score this explains
* [Resilience indicator licensing](/docs/methodology/resilience-indicator-licensing)
