Skip to main content
GET
Country 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_....

Path Parameters

iso2
string
required

ISO 3166-1 alpha-2 country code (e.g. SA).

Query Parameters

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

Page size, 1–500.

offset
integer

Rows to skip, default 0.

Response

OK

The response is of type object.