Skip to main content
GET
GetIntelTimeline

Authorizations

X-WorldMonitor-Key
string
header
required

User-issued WorldMonitor API key.

Query Parameters

domain
string

Restrict to one producing domain. Required unless country is set.

Pattern: ^(conflict|military|energy)?$
country
string

Restrict to one ISO 3166-1 alpha-2 country. Required unless domain is set. Supplying both narrows to their intersection.

Pattern: ^([A-Z]{2})?$
from
string<int64>

Earliest occurred_at to return, Unix epoch milliseconds, inclusive. 0 or omitted means no lower bound.

to
string<int64>

Latest occurred_at to return, Unix epoch milliseconds, inclusive. 0 or omitted means no upper bound.

limit
integer<int32>

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).

cursor
string

Opaque next_cursor from the preceding response. Omit for the first page. Keep domain, country, from and to unchanged between pages.

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

GetIntelTimelineResponse returns the scoped history newest-first.

records
object[]
partial
boolean

True when more history may remain after this bounded page. Continue with next_cursor, including when records is empty.

upstreamUnavailable
boolean

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.

nextCursor
string

Continue with this cursor, even when records is empty. Empty means the scoped archive is exhausted. Also empty when upstream_unavailable is true.