The ConflictService provides APIs for accessing armed conflict event data from multiple authoritative sources including ACLED (Armed Conflict Location & Event Data Project), UCDP (Uppsala Conflict Data Program), and HAPI/HDX (Humanitarian API) for humanitarian summaries.
Base Path ListAcledEvents Retrieves armed conflict events from the ACLED dataset with filtering by time range and country.
Endpoint: GET /api/conflict/v1/list-acled-eventsRequest Parameters Start of time range (inclusive), Unix epoch milliseconds
End of time range (inclusive), Unix epoch milliseconds
Maximum items per page (1-100)
Optional country filter (ISO 3166-1 alpha-2)
Response The list of ACLED conflict events Unique ACLED event identifier
ACLED event type classification (e.g., “Battles”, “Explosions/Remote violence”)
Country where the event occurred
Geographic location of the event
Time the event occurred, as Unix epoch milliseconds
Reported fatalities from this event
Named actors involved in the event
Administrative region within the country
Example Request curl "https://your-domain.com/api/conflict/v1/list-acled-events?start=1704067200000&end=1706745600000&country=UA&page_size=50"
Example Response { "events" : [ { "id" : "12345678" , "event_type" : "Battles" , "country" : "Ukraine" , "location" : { "latitude" : 48.379433 , "longitude" : 31.16558 }, "occurred_at" : 1704153600000 , "fatalities" : 12 , "actors" : [ "Military Forces of Ukraine" , "Military Forces of Russia" ], "source" : "Reuters" , "admin1" : "Dnipropetrovska" } ], "pagination" : { "cursor" : "eyJvZmZzZXQiOjUwfQ==" , "has_more" : true } }
ListUcdpEvents Retrieves georeferenced violence events from the UCDP (Uppsala Conflict Data Program) dataset.
Endpoint: GET /api/conflict/v1/list-ucdp-eventsRequest Parameters Start of time range (inclusive), Unix epoch milliseconds
End of time range (inclusive), Unix epoch milliseconds
Maximum items per page (1-100)
Optional country filter (ISO 3166-1 alpha-2)
Response The list of UCDP violence events Unique UCDP event identifier
Start date of the event, as Unix epoch milliseconds
End date of the event, as Unix epoch milliseconds
Geographic location of the event
Country where the event occurred
Primary party in the conflict (Side A)
Secondary party in the conflict (Side B)
Type of violence: UCDP_VIOLENCE_TYPE_STATE_BASED, UCDP_VIOLENCE_TYPE_NON_STATE, or UCDP_VIOLENCE_TYPE_ONE_SIDED
Original source of the event report
Example Request curl "https://your-domain.com/api/conflict/v1/list-ucdp-events?start=1704067200000&end=1706745600000&page_size=25"
GetHumanitarianSummary Retrieves a humanitarian overview for a country from HAPI/HDX, including conflict event counts and fatality statistics.
Endpoint: GET /api/conflict/v1/get-humanitarian-summaryRequest Parameters ISO 3166-1 alpha-2 country code (e.g., “YE”, “SD”, “SO”)
Response summary
HumanitarianCountrySummary
The humanitarian summary for the country Show HumanitarianCountrySummary
ISO 3166-1 alpha-2 country code
Total conflict events in the reference period
conflict_political_violence_events
Political violence + civilian targeting event count
Total fatalities from political violence and civilian targeting
Reference period start date (YYYY-MM-DD)
Number of demonstration events
Last data update time, as Unix epoch milliseconds
Example Request curl "https://your-domain.com/api/conflict/v1/get-humanitarian-summary?country_code=YE"
Example Response { "summary" : { "country_code" : "YE" , "country_name" : "Yemen" , "conflict_events_total" : 1247 , "conflict_political_violence_events" : 892 , "conflict_fatalities" : 3421 , "reference_period" : "2024-01-01" , "conflict_demonstrations" : 143 , "updated_at" : 1709251200000 } }
ListIranEvents Retrieves scraped conflict events from LiveUAMap Iran for real-time situational awareness.
Endpoint: GET /api/conflict/v1/list-iran-eventsRequest Parameters No parameters required.
Response The list of Iran conflict events URL to the source article
Human-readable location name
Event timestamp, as Unix epoch milliseconds
Timestamp when the data was scraped, as Unix epoch milliseconds
Example Request curl "https://your-domain.com/api/conflict/v1/list-iran-events"