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

# GetCountryHistory

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

## Request

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

Daily country snapshots with source versions, gaps and tier-limited depth.

## Query parameters

- `country` string, required
- `days` integer
- `jmespath` string

## Response `200`

OK

- WorldmonitorIntelligenceV1GetCountryHistoryResponse
  - `country` string
  - `requestedDays` integer
  - `allowedDays` integer
  - `effectiveDays` integer
  - `returnedDays` integer
  - `points` WorldmonitorIntelligenceV1CountryHistoryPoint[]
    - `date` string
    - `capturedAt` integer: Warning: Values > 2^53 may lose precision in JavaScript
    - `cii` WorldmonitorIntelligenceV1CountryHistoryScore
      - `score` number, double
      - `version` string: Source formula/cache identity.
      - `observedAt` integer: Warning: Values > 2^53 may lose precision in JavaScript
    - `resilience` WorldmonitorIntelligenceV1CountryHistoryScore
      - `score` number, double
      - `version` string: Source formula/cache identity.
      - `observedAt` integer: Warning: Values > 2^53 may lose precision in JavaScript
    - `topEvents` WorldmonitorIntelligenceV1CountryHistoryEvent[]
      - `title` string
      - `link` string
      - `source` string
      - `category` string
    - `keySignals` string[]
    - `ciiVersionBreak` boolean: Do not join trends across missing dates, absent scores or formula changes.
    - `resilienceVersionBreak` boolean
  - `upstreamUnavailable` boolean: True on failed reads or before activation.
  - `stale` boolean: True if unavailable or over 36 hours since publication.
  - `fetchedAt` integer: Warning: Values > 2^53 may lose precision in JavaScript

## Other responses

- `400`: Validation error
- `401`: Invalid supplied credentials. Omit credentials for seven-day access.
- `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)