Skip to main content
GET
GetForecasts

Authorizations

X-WorldMonitor-Key
string
header
required

User-issued WorldMonitor API key.

Query Parameters

domain
enum<string>

Forecast domain to retrieve, such as geopolitics, markets, or climate.

Available options:
conflict,
market,
supply_chain,
political,
military,
cyber,
infrastructure
region
string

Optional geographic or thematic region filter for forecasts.

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

forecasts
object[]
generatedAt
integer<int64>

Warning: Values > 2^53 may lose precision in JavaScript

degraded
boolean

True when the forecast backend could not read the canonical cache. Distinguishes an outage from a healthy empty forecast set.

stale
boolean

True when forecasts are served from a stale fallback. Currently false for this endpoint because get-forecasts does not have a stale fallback cache.

error
string

Stable machine-readable reason when degraded=true, empty otherwise. Value: "forecast_backend_unavailable" on Redis/backend read failures.