---
title: "GetCountryRisk"
method: GET
path: "/api/intelligence/v1/get-country-risk"
tags: ["IntelligenceService"]
---

# GetCountryRisk

`GET /api/intelligence/v1/get-country-risk`

## Request

- Base URL: `https://api.worldmonitor.app`
- URL: `https://api.worldmonitor.app/api/intelligence/v1/get-country-risk`
- Auth: one of:
  - API key in header `X-WorldMonitor-Key`
  - API key in header `X-Api-Key`

GetCountryRisk retrieves composite risk intelligence for a specific country.

## Query parameters

- `country_code` string, required
- `jmespath` string

## Response `200`

OK

- WorldmonitorIntelligenceV1GetCountryRiskResponse: GetCountryRiskResponse contains composite risk intelligence for a specific country.
  - `countryCode` string: ISO 3166-1 alpha-2 country code.
  - `countryName` string: Country name.
  - `cii` WorldmonitorIntelligenceV1CiiScore: CiiScore represents a Composite Instability Index score for a region or country.
    - `region` string: Region or country identifier.
    - `staticBaseline` number, double: Static baseline score (0-100).
    - `dynamicScore` number, double: Approximate 24-hour score movement delta (-100 to 100). Positive means rising, negative means falling, and 0 means stable or no valid prior snapshot.
    - `combinedScore` number, double: Combined weighted score (0-100).
    - `trend` 'TREND_DIRECTION_UNSPECIFIED' | 'TREND_DIRECTION_RISING' | 'TREND_DIRECTION_STABLE' | 'TREND_DIRECTION_FALLING': TrendDirection represents the directional movement of a metric over time. Used in markets, GDELT tension scores, and risk assessments.
    - `components` WorldmonitorIntelligenceV1CiiComponents: CiiComponents represents the contributing factors to a CII score.
      - `newsActivity` number, double: Information-environment contribution from news urgency and threat-summary signals (0-100).
      - `ciiContribution` number, double: Domestic unrest contribution from protests, riots, fatalities, severity, and outages (0-100).
      - `geoConvergence` number, double: Armed-conflict contribution from ACLED events, fatalities, civilian violence, GDELT conflict coverage, and OREF alerts (0-100).
      - `militaryActivity` number, double: Security-mobility contribution from military flights, military vessels, aviation disruption, and GPS interference (0-100).
    - `computedAt` integer: Warning: Values > 2^53 may lose precision in JavaScript
    - `methodologyVersion` string: Methodology version string for this score (for example, the current CII formula version). Bumped whenever CII_FORMULA_VERSION changes so API clients can detect score or movement-semantics drift. See docs/methodology/cii-risk-scores.mdx.
    - `eventMultiplier` number, double: Editorial per-country event multiplier applied to live signals before they roll into the composite score, in [0, 10]. See docs/methodology/cii-risk-scores.mdx.
    - `advisoryLevel` string: Travel advisory level used by the score, when any advisory input applies. Empty means no live or fallback advisory level affected boosts/floors.
    - `advisoryProvenance` string: Provenance for advisory_level: "live" when sourced from the Redis advisory feed, "fallback" when using the embedded State Department fallback table, and "absent" when no advisory input affected this score.
  - `advisoryLevel` string: Travel advisory level from government sources (e.g. "do-not-travel", "reconsider", "caution"). Empty if none.
  - `sanctionsActive` boolean: Whether this country has active OFAC sanctions designations.
  - `sanctionsCount` integer: Count of sanctioned entities associated with this country.
  - `fetchedAt` integer: Warning: Values > 2^53 may lose precision in JavaScript
  - `upstreamUnavailable` boolean: True when all upstream Redis keys were unavailable. Signals CDN cache bypass.

## Other responses

- `400`: Validation error
- `401`: Missing or invalid API key.
- `403`: API access requires an active subscription (the API key's subscription is inactive or expired).
- `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)