GetIntelTimeline
GetIntelTimeline returns the durable historical intelligence store newest-first for one domain and/or country. Pure index read — no embedding, no ranking. Premium-gated. PRO-gated. Requires entitlement tier >= 1.
Authorizations
User-issued WorldMonitor API key.
Query Parameters
Restrict to one producing domain. Required unless country is set.
^(conflict|military|energy)?$Restrict to one ISO 3166-1 alpha-2 country. Required unless domain is
set. Supplying both narrows to their intersection.
^([A-Z]{2})?$Earliest occurred_at to return, Unix epoch milliseconds, inclusive. 0 or omitted means no lower bound.
Latest occurred_at to return, Unix epoch milliseconds, inclusive. 0 or omitted means no upper bound.
Maximum events to return. Defaults to 50 server-side when omitted or <= 0; the handler caps it at 200, the TIMELINE_MAX_LIMIT the Convex query clamps to (convex/intelHistory.ts).
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
GetIntelTimelineResponse returns the scoped history newest-first.
True when the bounded post-filter candidate window may omit older events.
True when the history store could not be reached. The gateway reads this flag out of the body and switches the response to Cache-Control: no-store, so a transient outage is never pinned as a false-empty timeline for the tier's full TTL.
