04 · API · Open Source
One API for the
humanitarian data commons.
API-first. 4-layer architecture: ingestion, processing, governed storage, access. Every signal traceable. Every model explainable.
An umbrella API connecting the sector's existing platforms. Not another silo, but a shared substrate.
Federated
Data stays where it belongs. Compute moves to data.
Explainable
Every output ships with its sources and confidence.
Shared registry
Models + features re-used across orgs, not rebuilt.
Cloud-agnostic
No vendor lock-in. Deployable on-prem.
$ api.clearinitiative.io / v0 / signals
200 OK · 142ms
# Subscribe to verified signals for a country & threshold
curl https://api.clearinitiative.io/v0/signals \
-H "Authorization: Bearer $TOKEN" \
-d 'country=SDN&min_severity=0.6&verified=true'
# → Returns a stream of structured, traceable events
{
"event_id": "evt_sdn_blnile_20260513_0614",
"type": "displacement.surge",
"geo": { "admin1": "Blue Nile", "lat": 11.78, "lon": 34.35 },
"severity": 0.92,
"sources": ["sat:s2-l2a", "field:nrc-roseires", "social:gdelt-2.0"],
"verified": true,
"estimated_affected": 47000,
"explain": "https://clearinitiative.io/evt/.../explain",
"feedback": { "community_signal": 0.81, "n_voices": 142 }
}