GetRegimeHistory
GetRegimeHistory returns the region’s regime transition log newest-first. Entries are append-only from the seed writer, recorded only when diffRegionalSnapshot reports regime_changed. Premium-gated. PRO-gated. Requires an active Pro subscription.
Authorizations
User-issued WorldMonitor API key.
Query Parameters
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.
^[a-z][a-z0-9]*(-[a-z0-9]+)*$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).
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).
