Skip to main content
GET
GetRegimeHistory

Authorizations

X-WorldMonitor-Key
string
header
required

User-issued WorldMonitor API key.

Query Parameters

region_id
string
required

Display region id (e.g. "mena", "east-asia", "europe"). See shared/geography.js. Kebab-case: lowercase alphanumeric groups separated by single hyphens, no trailing or consecutive hyphens.

Pattern: ^[a-z][a-z0-9]*(-[a-z0-9]+)*$
limit
integer<int32>

Optional cap on how many entries to return. Defaults to 50 server-side when omitted or <= 0. Hard cap enforced by the handler at 100 (= the writer-side LTRIM cap in regime-history.mjs).

jmespath
string

Optional JMESPath expression applied server-side to project or reduce the JSON response before it is returned (mirrors the MCP jmespath argument). Invalid expressions, expressions larger than 1024 UTF-8 bytes, or projections that exceed the 256 KB output cap return HTTP 400 with a {_jmespath_error, original_keys} envelope. Grammar and worked examples: https://www.worldmonitor.app/docs/mcp-jmespath.

Response

Successful response

GetRegimeHistoryResponse returns the region's regime transition log newest-first. The list is append-only from the seed writer's perspective: only diffs with regime_changed set produce an entry, so this is a pure transition stream (no steady-state noise).

transitions
object[]