africaAPI

Guides

Disasters

Use GDACS disaster alerts in country signals to surface current flood, cyclone, wildfire, earthquake, and volcanic-risk context.

Current Disaster Context

Africa API exposes current GDACS disaster alerts inside:

  • GET /v1/countries/{country_code}/signals

This keeps operational risk context close to current macro signals, local prices, FX, markets, trade, and government context.

Fields

Each disaster alert can include:

  • event_key
  • event_type
  • name
  • description
  • alert_level
  • alert_score
  • severity_value
  • severity_text
  • severity_unit
  • event_from_at
  • event_to_at
  • source_modified_at
  • report_url
  • details_url
  • source_system
  • source
  • freshness

Example

Request
curl "https://api.africa-api.com/v1/countries/mz/signals" \
  -H "Authorization: Bearer $AFRICA_API_KEY"
Disaster Alert Block
{
  "disaster_alerts": [
    {
      "event_key": "1102919:1:fl:mz",
      "event_type": "FL",
      "name": "Flooding in Mozambique",
      "description": "Heavy rain and flooding conditions",
      "alert_level": "orange",
      "alert_score": 2.4,
      "severity_value": 120.0,
      "severity_text": "Heavy rain",
      "severity_unit": "mm/24h",
      "event_from_at": "2026-03-13T09:00:00Z",
      "event_to_at": "2026-03-16T09:00:00Z",
      "source_modified_at": "2026-03-13T10:30:00Z",
      "report_url": "https://www.gdacs.org/report.aspx?eventid=1102919",
      "details_url": "https://www.gdacs.org/report.aspx?eventid=1102919&episodeid=1",
      "source_system": "GDACS",
      "source": "gdacs_disaster_alerts",
      "freshness": "current"
    }
  ]
}

Notes

  • Alerts are current-event context, not historical indicator series.
  • Countries without active GDACS coverage return an empty disaster_alerts array.
  • For provenance and source monitoring, see Platform and Sources.

On this page