v5

latestOpenAPI 3.1.0Proprietary2026-08-031,5423,1505.5 MB

Disasters & Hazards

Multi-hazard alerts (GDACS)

Current GDACS (EC JRC + UN OCHA/UNOSAT) multi-hazard alerts - a cross-hazard OVERLAY (earthquake / tropical cyclone / flood / drought / volcano / wildfire) with a Green/Orange/Red alert level and exposed-population estimate. Filter by hazard type, alert level and bounding box. Automated, not human-reviewed; not a substitute for official warnings. Each event carries the upstream sourceid for cross-referencing.

get/api/v2/hazards/alerts

Query parameters

event_typestring nullable

alert_levelstring nullable

green | orange | red.

min_latnumber nullable

max_latnumber nullable

min_lonnumber nullable

max_lonnumber nullable

limitinteger

Maximum alerts returned (most recently updated first).

Response

Successful Response

Example response

{
  "data": {
    "query": {
      "event_type": "earthquake",
      "alert_level": "red",
      "limit": 200
    },
    "events": [
      {
        "schema_version": "hazard-event/2",
        "event_id": "gdacs-EQ-1234-1",
        "event_type": "earthquake",
        "geometry": {
          "lat": 34.1,
          "lon": -118.2,
          "depth_km": 8
        },
        "metrics": {
          "alert_level": "Orange",
          "severity_value": 6.2,
          "severity_text": "Magnitude 6.2M",
          "severity_unit": "M",
          "upstream_source": "USGS",
          "upstream_source_id": "us7000abcd",
          "gdacs_event_type": "EQ"
        },
        "severity": {
          "severity": "Moderate",
          "certainty": "Observed",
          "urgency": "Past",
          "derivation": "sugra-computed"
        },
        "source": {
          "institution": "USGS",
          "tier": "S"
        }
      }
    ],
    "attribution": {
      "sources": [
        {
          "registry_key": "usgs/earthquake",
          "source_name": "USGS Earthquake",
          "licence": "public-domain",
          "citation": "U.S. Geological Survey Earthquake Hazards Program",
          "disclaimer": "Magnitudes are preliminary and subject to revision."
        }
      ],
      "effective_reexport": "allowed"
    }
  },
  "meta": {
    "endpoint": "/api/v1/fred/us/cpi",
    "data_time": "2026-04-16T14:30:00Z",
    "response_time": "2026-04-16T14:30:12Z",
    "provider": "Sugra API v1.0.1",
    "source": "sugra_crypto",
    "attribution": "Short interest and Reg SHO daily short volume data is owned by and sourced from FINRA (Financial Industry Regulatory Authority).",
    "fallback_chain": [
      "sugra_crypto",
      "sugra_finance"
    ]
  }
}