Catalog/science-disaster-alerts

Science

Global multi-hazard disaster alerts (GDACS) API

GDACS global disaster events (earthquakes, tropical cyclones, floods, volcanoes, droughts, wildfires) normalized from geojson into clean records with hazard name, country, alert level (Green/Orange/Red), alert score, severity text, coordinates, date range and report URL; optionally filtered by eventType and minimum alert level, ranked by alert score, with an alert-level rollup. Answers 'any Red-level disasters worldwide right now?', 'active tropical cyclones?', 'recent significant earthquakes globally with impact estimates?'.

Price$0.01per request
MethodPOST
Route/v1/science/disaster-alerts
StatusLive
MIME typeapplication/json
Rate limit60/minute
Cache3600s public
sciencedisasterhazardgdacsearthquakecyclonefloodvolcanodroughtglobalalert
API URLhttps://x402.hexl.dev/v1/science/disaster-alerts
Integration docs
Example request
{
  "limit": 5
}
Example response
{
  "filters": {
    "eventType": null,
    "minAlert": null
  },
  "count": 5,
  "highestAlert": "Orange",
  "countByAlertLevel": {
    "Orange": 1,
    "Green": 4
  },
  "events": [
    {
      "eventType": "DR",
      "hazard": "Drought",
      "eventId": 1018431,
      "name": "Drought in Madagascar",
      "country": "Madagascar",
      "iso3": "MDG",
      "alertLevel": "Orange",
      "alertScore": 2,
      "severity": "Medium impact for agricultural drought in 398352 km2",
      "fromDate": "2025-11-21T00:00:00",
      "toDate": "2026-06-02T00:00:00",
      "lat": -20.506,
      "lon": 46.567,
      "reportUrl": "https://www.gdacs.org/report.aspx?eventid=1018431&episodeid=5&eventtype=DR"
    },
    {
      "eventType": "FL",
      "hazard": "Flood",
      "eventId": 1103925,
      "name": "Flood in Croatia",
      "country": "Croatia",
      "iso3": "HRV",
      "alertLevel": "Green",
      "alertScore": 1,
      "severity": "Magnitude 0",
      "fromDate": "2026-06-03T01:00:00",
      "toDate": "2026-06-05T01:00:00",
      "lat": 43.5116,
      "lon": 16.44,
      "reportUrl": "https://www.gdacs.org/report.aspx?eventid=1103925&episodeid=1&eventtype=FL"
    },
    {
      "eventType": "FL",
      "hazard": "Flood",
      "eventId": 1103926,
      "name": "Flood in Poland",
      "country": "Poland",
      "iso3": "POL",
      "alertLevel": "Green",
      "alertScore": 1,
      "severity": "Magnitude 0",
      "fromDate": "2026-06-03T01:00:00",
      "toDate": "2026-06-05T01:00:00",
      "lat": 50.0661,
      "lon": 18.5941,
      "reportUrl": "https://www.gdacs.org/report.aspx?eventid=1103926&episodeid=1&eventtype=FL"
    },
    {
      "eventType": "FL",
      "hazard": "Flood",
      "eventId": 1103927,
      "name": "Flood in Slovenia",
      "country": "Slovenia",
      "iso3": "SVN",
      "alertLevel": "Green",
      "alertScore": 1,
      "severity": "Magnitude 0",
      "fromDate": "2026-06-03T01:00:00",
      "toDate": "2026-06-05T01:00:00",
      "lat": 46.5221,
      "lon": 16.1313,
      "reportUrl": "https://www.gdacs.org/report.aspx?eventid=1103927&episodeid=1&eventtype=FL"
    },
    {
      "eventType": "EQ",
      "hazard": "Earthquake",
      "eventId": 1544264,
      "name": "Earthquake in Venezuela",
      "country": "Venezuela",
      "iso3": "VEN",
      "alertLevel": "Green",
      "alertScore": 1,
      "severity": "Magnitude 4.8M, Depth:10km",
      "fromDate": "2026-06-04T23:41:15",
      "toDate": "2026-06-04T23:41:15",
      "lat": 9.6333,
      "lon": -70.0495,
      "reportUrl": "https://www.gdacs.org/report.aspx?eventid=1544264&episodeid=1709744&eventtype=EQ"
    }
  ]
}
Input schema
{
  "type": "object",
  "properties": {
    "eventType": {
      "type": "string",
      "enum": [
        "EQ",
        "TC",
        "FL",
        "VO",
        "DR",
        "WF",
        "TS"
      ],
      "description": "Filter by hazard: EQ=earthquake, TC=cyclone, FL=flood, VO=volcano, DR=drought, WF=wildfire, TS=tsunami."
    },
    "minAlert": {
      "type": "string",
      "enum": [
        "Green",
        "Orange",
        "Red"
      ],
      "description": "Minimum alert level."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "default": 25,
      "description": "Max events to return."
    }
  },
  "additionalProperties": false
}
Output schema
{
  "type": "object",
  "additionalProperties": true
}