Skip to content
HALOWERK

Weltwerk

volcano alerts

Reads the USGS Volcano Hazards Program API: the status list of all US volcanoes with aviation colour code and alert level, the elevated-volcano notices with synopsis and notice URL, and the world volcano list (Smithsonian GVP numbering as published by USGS) for distance queries. Returns all US volcanoes above NORMAL with alert level, colour code, synopsis and date, and, if lat/lon are given, the nearest volcanoes within the radius with country, elevation, distance and, for US volcanoes, the.

POST https://welt.halowerk.com/v1/volcano-alerts

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
latnumberNoLatitude in decimal degrees (WGS84).
lonnumberNoLongitude in decimal degrees.
radius_kmnumberNoRadius for the nearest-volcano search (default 300).
limitintegerNoMaximum nearest volcanoes (default 5).
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "lat": {
      "type": "number",
      "minimum": -90,
      "maximum": 90,
      "description": "Latitude in decimal degrees (WGS84)."
    },
    "lon": {
      "type": "number",
      "minimum": -180,
      "maximum": 180,
      "description": "Longitude in decimal degrees."
    },
    "radius_km": {
      "type": "number",
      "minimum": 10,
      "maximum": 1000,
      "description": "Radius for the nearest-volcano search (default 300)."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 20,
      "description": "Maximum nearest volcanoes (default 5)."
    }
  }
}

Open original schema

Published input example

{
  "lat": 61.2,
  "lon": -149.9,
  "radius_km": 300
}

Result & documentation

Machine-readable documentation of this hub

Source of this page: the published HALOWERK catalog. Updated: 2026-11-17 UTC.

More endpoints in this hub

All endpoints in this hub →