// Product Docs

Region Events

Aggregated event view derived from current regional news updates rather than a complete global event archive.

What it returns

Region Events return recent non-empty event aggregates derived from current regional news updates and event classification logic.

Request shape

Use geo_object_id with a date range. Read event_count and event_types as aggregated output rather than raw event rows.

Sample request

GET /v1/events/region-aggregate?geo_object_id=GLOBAL&start_date=2026-03-28&end_date=2026-03-28

Sample response

[
  {
    "geo_object_id": "GLOBAL",
    "event_types": ["conflict"],
    "event_count": 2,
    "latest_run_id": "soak3h_newsdata_20260329T053300Z_it5_newsdata"
  }
]

Query parameters

The event aggregate surface is date-bounded.

Parameter	Required	Description
geo_object_id	Yes	Regional contract key.
start_date	Yes	Start date for aggregate computation.
end_date	Yes	End date for aggregate computation.

Current boundary

This live surface favors recent updates with event activity. It is not a promise of complete global event coverage on every cycle.