Alpha · Live in Sudan

Build on the
humanitarian data commons.

CLEAR API is the developer interface to the CLEAR data commons — one GraphQL endpoint for verified crisis signals, events, alerts, and the geography they happen in. Built and operated by NRC.

Read the Guide → Open the Sandbox

$ curl api.clearinitiative.io/graphql

POST  /graphql200 OK · 142ms
# Verified events anywhere inside Sudan
{
  eventsByLocation(locationId: "sdn") {
    id
    title
    severity
    types
    generalLocation { name }
  }
}

# → one record from the response
{
  "id":       "evt_blnile_0614",
  "title":    "Displacement surge — Blue Nile",
  "severity": 5,
  "types":    ["displacement", "conflict"],
  "generalLocation": { "name": "Blue Nile" }
}

01 · The CLEAR API

One endpoint. Three tiers.

Detected signals become a connected commons, which sovereign AI reasons over — into briefings you can build on. Select a tier to see what it covers.

One GraphQL endpoint touches every tier · POST api.clearinitiative.io/graphql Read the guide →
02 · The data

Five tiers. One graph.

Raw observations flow in at the bottom and are grouped, classified, and escalated into briefings at the top. Almost every query you write touches one of these.

Location
The administrative hierarchy — country → state → district → point. Everything else hangs off this tree.
Signal
A single raw observation from satellite, field reports, social, or conflict feeds — or filed manually.
Event
A cluster of related signals, classified by disaster type and bound to a district.
Alert
A severe event escalated for notification and delivered to subscribers.
Crisis
Curated events enriched by an LLM into a summary, forward scenarios, and a needs analysis.

Everything is geolocated — which is why the …ByLocation queries are the sharpest way to slice the data. See the full walkthrough →

03 · Start building

Three ways in.

From zero knowledge to a working integration in about ten minutes.

01

Read the Guide

The mental model, your first authenticated request, and two real queries — end to end.

Build your first integration →
02

Open the Sandbox

Browse the full schema with autocomplete and run live GraphQL queries in your browser.

Explore the schema →
03

Get an API Key

Create a key in the Developer Portal and authenticate with a Bearer token.

Open the portal →

CLEAR API is part of the CLEAR Initiative — NRC’s open infrastructure for crisis learning, early-warning, anticipation, and response. The mission, the backbone, and the pilot live on the main site.

Read the mission →