Skip to main content
GET
Armed conflicts

Authorizations

X-API-KEY
string
header
default:pk_live_YOUR_KEY
required

Astreus API key (pk_live_...), created on the Developers page in the terminal. Also accepted as Authorization: Bearer pk_live_....

Query Parameters

country
string

ISO alpha-2 state that took part, either side.

region
string

One of africa, americas, asia, europe, global, middle_east, oceania.

kind
string

Conflict types, comma-separated, from interstate, intrastate, internationalized_intrastate, extrasystemic, operation, crisis.

active_in
integer

A year (1800–2100) the conflict was active in.

from
string<date>

First day (conflicts overlapping the window), YYYY-MM-DD.

to
string<date>

Last day, YYYY-MM-DD.

ongoing
string

1 or true: only ongoing conflicts. 0 or false: only ended ones. Any other value is a 400.

q
string

Words that must all appear in the conflict's name or location.

limit
integer
default:50

Page size, 1–500.

Required range: 1 <= x <= 500
offset
integer
default:0

Rows to skip, default 0.

Required range: x >= 0

Response

OK

Inferred from captured responses: every field shown was returned by a real call; a field may be absent or null on other calls.

conflicts
object