---
title: "GetResilienceIndicators"
method: GET
path: "/api/resilience/v1/get-resilience-indicators"
tags: ["ResilienceService"]
---

# GetResilienceIndicators

`GET /api/resilience/v1/get-resilience-indicators`

## Request

- Base URL: `https://api.worldmonitor.app`
- URL: `https://api.worldmonitor.app/api/resilience/v1/get-resilience-indicators`
- Auth: one of:
  - API key in header `X-WorldMonitor-Key`
  - API key in header `X-Api-Key`
  - HTTP bearer

GetResilienceIndicators explains one country's score at indicator level. PRO-gated. Requires entitlement tier >= 1.

## Query parameters

- `countryCode` string, required
- `jmespath` string

## Response `200`

OK

- WorldmonitorResilienceV1GetResilienceIndicatorsResponse
  - `countryCode` string: Normalized ISO 3166-1 alpha-2 country code used by the scorer.
  - `methodology` string: Stable decomposition method used to reconcile rows to dimension scores.
  - `formula` string: Active score formula tag, for example d6 or pc.
  - `dataVersion` string: Source snapshot version used for the score, normally an ISO date.
  - `schemaVersion` string: Public resilience score schema version.
  - `constructVersions` WorldmonitorResilienceV1ResilienceRuntimeConstructVersions
    - `energy` string: Safe derived energy construct version. Valid values: "legacy" or "v2".
    - `education` string: Safe derived education construct version. Valid values: "active" or "rollback".
    - `financialSystemExposure` string: Safe derived financial-system construct version. Valid values: "active" or "rollback".
  - `dimensions` WorldmonitorResilienceV1ResilienceIndicatorDimension[]
    - `id` string: Stable dimension identifier from the resilience construct.
    - `score` number, double: Final dimension score on the 0-100 scale.
    - `coverage` number, double: Fraction of active dimension weight backed by observations, from 0 to 1.
    - `prePolicyScore` number, double: Dimension score before a policy cap or other post-blend adjustment.
    - `policyCapName` string: Name of the applied post-blend policy cap, or empty when none applies.
    - `policyCapFactor` number, double: Multiplicative factor applied by the post-blend policy cap.
    - `literalContributionTotal` number, double: Sum of literal indicator contributions before dimension-level policy.
    - `effectiveContributionTotal` number, double: Sum of exposed effective contributions. This reconciles to score.
    - `active` boolean: False for retired or runtime-disabled placeholder dimensions.
    - `reconciliationAvailable` boolean: True when effective_contribution_total is required to equal score.
    - `reason` string: Explanation when this dimension is inactive or cannot reconcile contributions.
  - `indicators` WorldmonitorResilienceV1ResilienceIndicator[]
    - `id` string: Stable indicator identifier from the 72-row registry.
    - `dimension` string: Stable identifier of the dimension that owns this indicator.
    - `tier` string: Scoring tier: core, enrichment, or experimental.
    - `active` boolean: Active means the current construct version can use this indicator.
    - `includedInDimensionScore` boolean: True when this country observation participated in the dimension score.
    - `state` string: observed, imputed, missing, fallback, source-failure, inactive, retired, or not-applicable.
    - `reason` string: Explains exclusion, inactive selection, retirement, or fallback state.
    - `normalizedScoreAvailable` boolean: True when normalized_score contains the score used by the scorer.
    - `normalizedScore` number, double: Indicator score normalized to the 0-100 resilience scale.
    - `nominalWeight` number, double: Configured indicator weight before runtime selection or reweighting.
    - `runtimeWeightAvailable` boolean: True when runtime_weight applies to this execution path.
    - `runtimeWeight` number, double: Weight selected by the executed scorer branch before normalization.
    - `scoringWeightShareAvailable` boolean: True when scoring_weight_share applies to this execution path.
    - `scoringWeightShare` number, double: Indicator share of the active blend after runtime reweighting.
    - `literalContribution` number, double: Indicator contribution before dimension-level caps or adjustments.
    - `effectiveContribution` number, double: Reconciled contribution after dimension-level caps or adjustments.
    - `imputationClass` string: Empty for observed or unavailable rows; otherwise the scorer taxonomy.
    - `sourceYearAvailable` boolean: True when source_year contains the provider observation year.
    - `sourceYear` integer: Provider observation year, not the WorldMonitor retrieval year.
    - `observationAgeAvailable` boolean: Age of the source observation, not the time since WorldMonitor fetched it.
    - `observationAgeValue` integer: Integer observation age expressed in observation_age_unit.
    - `observationAgeUnit` string: "days" for an observation timestamp or "years" for an annual source row.
    - `observationAgeBasis` string: "observation-timestamp" or "source-year". Never derived from retrieval time.
    - `retrievedAtAvailable` boolean: True when retrieved_at contains an explicit retrieval timestamp.
    - `retrievedAt` string: Explicit ISO-8601 retrieval timestamp; never inferred from source year.
    - `observedAtAvailable` boolean: True when observed_at contains a provider observation timestamp.
    - `observedAt` string: Provider observation timestamp in ISO-8601 form.
    - `sources` WorldmonitorResilienceV1ResilienceIndicatorSource[]
      - `key` string: Stable source or cache key used by the resilience scorer.
      - `name` string: Human-readable provider or dataset name.
      - `attribution` string: Attribution text that callers must preserve when displaying the value.
      - `license` string: Audited source license or redistribution classification.
      - `url` string: Canonical provider or methodology URL when one is available.
      - `observationProvenance` boolean: True only when this source was recorded for the selected country observation. False means the entry is registry attribution, not observation provenance.
      - `licenseUrl` string: Canonical URL for the audited source license or redistribution terms.
      - `attributionUrl` string: Canonical attribution URL when it differs from the source dataset URL.
    - `rawValue` WorldmonitorResilienceV1ResilienceIndicatorRawValue: Selectively exposed raw observation. Availability fields keep a withheld or absent value distinct from a genuine numeric zero or empty categorical value.
      - `available` boolean: True only when at least one raw value representation may be redistributed.
      - `numericValue` number, double: Numeric raw observation. Read numeric_value_available before this value.
      - `numericValueAvailable` boolean: True when numeric_value contains an audited redistributable observation.
      - `textValue` string: Categorical raw observation. Read text_value_available before this value.
      - `textValueAvailable` boolean: True when text_value contains an audited redistributable observation.
      - `unit` string: Unit attached to the raw observation, for example percent or days.
      - `status` string: available, absent, restricted, audit-incomplete, conditional, ineligible-observation, or unknown-indicator.
      - `reason` string: Human-readable explanation for an unavailable or withheld value.

## Other responses

- `400`: Validation error
- `401`: Missing or invalid API key.
- `403`: PRO entitlement access denied.
- `429`: Rate limit exceeded.
- `503`: Service unavailable. Billing-verification responses include code and X-Billing-Verification; other gateway infrastructure failures use the generic GatewayError shape.
- `default`: Gateway or handler error response.

---

[API](https://skmtc.dev/worldmonitor/apis/worldmonitor-api.md) · [All operations](https://skmtc.dev/worldmonitor/apis/worldmonitor-api/llms.txt) · [OpenAPI document](https://skmtc.dev/worldmonitor/apis/worldmonitor-api/revisions/e3dc8463a5c9?raw)
