Pages the COMPLETE list of items one triggered run matched, as it was at trigger time, with the current state of each hydrated live. GET /api/v2/monitors/{id}/runs/{runId} embeds a bounded SAMPLE of cards; this operation walks the whole matched set. Each entry carries as_triggered — exactly what the email or webhook asserted, frozen and never re-derived — alongside current, the live card, and a status of unchanged, updated, superseded or gone. superseded means a Story was merged away by same-day de-duplication; follow the id to GET /api/v2/stories/{story_id}, which answers 404 STORY_MERGED with the replacement id. Read result_count, retained_match_count and matched_items_truncated together: when the run matched more items than the writer retains, result_count remains the exact total and the retained list is a prefix that says so. Runs are retained for seven days.
GDELT Cloud API key. Send as Authorization: Bearer gdelt_sk_....
Matched items per page. Default 25, max 100. A value outside the range is refused, not clamped. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.
1 <= x <= 100Opaque cursor over the run's frozen matched-item list. Copy next_cursor from the previous response verbatim; omit it for the first page, and stop when it is null. It is not an offset — a plain integer is refused rather than answered with page one. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.