US volcanoes at elevated alert level (USGS) API

USGS Volcano Hazards Program elevated-volcano notices normalized and ranked by aviation color code (RED>ORANGE>YELLOW>GREEN) with volcano name, observatory, alert level (WATCH/WARNING/ADVISORY), coordinates, elevation and notice URL, plus a derived highest-color-code and any-eruption-watch flag. Answers 'which US volcanoes are at elevated alert?', 'is any volcano at ORANGE/RED?', 'current alert level for Kilauea?'.

Price$0.01per request

MethodPOST

Route/v1/science/volcano-alerts

StatusLive

MIME typeapplication/json

Rate limit60/minute

Cache3600s public

sciencevolcanohazardusgseruptionalert-levelcolor-codenatural-disastergeology

API URLhttps://x402.hexl.dev/v1/science/volcano-alerts

Integration docs

Example request

{}

Example response

{
  "count": 2,
  "highestColorCode": "ORANGE",
  "anyEruptionWatch": true,
  "volcanoes": [
    {
      "name": "Great Sitkin Volcano",
      "vnum": "311120",
      "observatory": "Alaska Volcano Observatory",
      "alertLevel": "WATCH",
      "colorCode": "ORANGE",
      "lat": 52.0765,
      "lon": -176.1109,
      "elevationM": 1740,
      "sentUtc": null,
      "noticeUrl": "https://volcanoes.usgs.gov/hans-public/notice/DOI-USGS-AVO-2026-06-04T19:17:45+00:00"
    },
    {
      "name": "Kilauea Volcano",
      "vnum": "332010",
      "observatory": "Hawaiian Volcano Observatory",
      "alertLevel": "ADVISORY",
      "colorCode": "YELLOW",
      "lat": 19.421,
      "lon": -155.287,
      "elevationM": 1247,
      "sentUtc": null,
      "noticeUrl": "https://volcanoes.usgs.gov/hans-public/notice/DOI-USGS-HVO-2026-06-04T17:49:49+00:00"
    }
  ]
}

Input schema

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}