Skip to main content
GET
/
api
/
conflict
/
v1
/
list-ucdp-events
ListUcdpEvents
curl --request GET \
  --url https://api.example.com/api/conflict/v1/list-ucdp-events
{
  "events": [
    {
      "id": "<string>",
      "dateStart": 123,
      "dateEnd": 123,
      "location": {
        "latitude": 0,
        "longitude": 0
      },
      "country": "<string>",
      "sideA": "<string>",
      "sideB": "<string>",
      "deathsBest": 123,
      "deathsLow": 123,
      "deathsHigh": 123,
      "violenceType": "UCDP_VIOLENCE_TYPE_UNSPECIFIED",
      "sourceOriginal": "<string>"
    }
  ],
  "pagination": {
    "nextCursor": "<string>",
    "totalCount": 123
  }
}

Query Parameters

start
string<int64>

Start of time range (inclusive), Unix epoch milliseconds.

end
string<int64>

End of time range (inclusive), Unix epoch milliseconds.

page_size
integer<int32>

Maximum items per page (1-100).

cursor
string

Cursor for next page.

country
string

Optional country filter (ISO 3166-1 alpha-2).

Response

Successful response

ListUcdpEventsResponse contains UCDP violence events matching the request.

events
object[]
pagination
object

PaginationResponse contains pagination metadata returned alongside list results.