USGS Volcano Hazards
App · 12 actions
Follow US volcanoes through the USGS Volcano Hazards Program: see which volcanoes are above normal and every monitored volcano's alert level and aviation color code, look up any US volcano, read and search the notices its observatories send (from daily updates to eruption warnings), and get the aviation notices (VONAs) and CAP alerts. No account or API key required.
Actions
| Action | What it does |
|---|---|
| Get a notice | Get one USGS volcano notice in full: its type, observatory and time, every volcano it covers with its alert level, color code, headline and summary, and the whole notice as plain text. |
| Get a volcano | Get one US volcano's details (location, elevation, threat category, USGS's description and links) with its current alert level, aviation color code and newest notice. |
| Get a volcano's newest notice | Get the newest notice USGS has sent about a volcano, in full: every volcano it covers with its level, headline and summary, the section about the volcano asked for, and the whole notice as plain text. |
| Get an aviation notice (VONA) | Get a Volcano Observatory Notice for Aviation (VONA): the message as pilots and dispatchers get it, and its lines read out (position, current and previous color code, activity, ash cloud height and movement, remarks). |
| List aviation notices (VONAs) | List the Volcano Observatory Notices for Aviation (VONAs) sent in the last year, newest first, with the volcano, its location, the color code set and a one-line summary. |
| List CAP alerts | List the Common Alerting Protocol (CAP) alerts USGS issues for volcanoes at ORANGE/WATCH or higher, including a 'Cancel' when one drops back below. |
| List elevated volcanoes | List the US volcanoes above normal right now: alert level ADVISORY, WATCH or WARNING, or aviation color code YELLOW, ORANGE or RED. |
| List monitored volcanoes | List every volcano USGS monitors closely enough to give an alert level, with its alert level, aviation color code and newest notice, and how many are at each level. |
| List observatories | List the six USGS volcano observatories with their contact address and how many notices of each kind each has sent, with the first and latest. |
| List recent notices | List the notices USGS volcano observatories sent in the last month, newest first, narrowed by observatory, notice type and how many days back. |
| List US volcanoes | List every volcano of the United States with its location, elevation, threat category and links, narrowed by observatory, threat category, or words in the name or region. |
| Search notices | Search every notice USGS volcano observatories have sent since 2006 by observatory, volcano, notice type, date range and words in the text, newest first, 20 a page. |
Get a notice
Get one USGS volcano notice in full: its type, observatory and time, every volcano it covers with its alert level, color code, headline and summary, and the whole notice as plain text.
Inputs
- Notice ID
notice_idtextRequired - The notice's ID, as the list and search actions give it, or the link to the notice on the USGS site.
Outputs
categorytext- 'Event Response / Information Statement' or 'Scheduled Update'.
foundtrue/false- Whether USGS has a notice with this ID.
highest_alert_leveltext- The highest alert level the notice gives.
highest_color_codetext- The highest aviation color code the notice gives.
notice_identifiertext- The notice's ID, such as 'DOI-USGS-HVO-2026-10-17T19:56:12+00:00'. 'Get a notice' takes it.
notice_typetext- The kind of notice, such as 'Daily Update'.
notice_type_codetext- The notice type's code: VAN (activity notification), VV (aviation notice, VONA), SR (status report), IS (information statement), DU, WU, BU or MU (daily, weekly, biweekly or monthly update).
notice_urltext- The notice's page on the USGS site.
observatory_codetext- The code of the USGS observatory that watches it, such as 'hvo'. The Observatory fields take it.
observatory_nametext- The observatory's name, such as 'Hawaiian Volcano Observatory'.
sent_attext- When the notice was sent, as an ISO 8601 date and time in UTC.
texttext- The whole notice as plain text, a line per paragraph, ready to send on.
titletext- The notice's title, such as 'HAWAIIAN VOLCANO OBSERVATORY DAILY UPDATE'.
volcano_codeslist- USGS's codes for the volcanoes the notice covers.
volcano_countnumber- How many volcanoes or areas the notice covers.
volcanoeslist- A section per volcano or area, in the notice's order.
vona_urltext- The aviation notice's (VONA's) page on the USGS site, when the notice is one; otherwise empty.
Example output
{
"category": "Scheduled Update",
"found": true,
"highest_alert_level": "WATCH",
"highest_color_code": "ORANGE",
"notice_identifier": "DOI-USGS-AVO-2026-10-23T18:32:10+00:00",
"notice_type": "Weekly Update",
"notice_type_code": "WU",
"notice_url": "https://volcanoes.usgs.gov/hans-public/notice/DOI-USGS-AVO-2026-10-23T18:32:10+00:00",
"observatory_code": "avo",
"observatory_name": "Alaska Volcano Observatory",
"sent_at": "2026-10-23T19:28:22Z",
"text": "ALASKA VOLCANO OBSERVATORY WEEKLY UPDATE\n\nU.S. Geological Survey\n\nFriday, October 23, 2026, 11:28 AM AKDT (Friday, October 23, 2026, 19:28 UTC)\n\nGREAT SITKIN (VNUM #311120)\n52\u00b04'35\" N 176\u00b06'39\" W, Summit Elevation 5709 ft (1740 m)\nCurrent Volcano Alert Level: WATCH\nCurrent Aviation Color Code: ORANGE\n\nSummary: Slow eruption of lava continues within the ...",
"title": "ALASKA VOLCANO OBSERVATORY WEEKLY UPDATE",
"volcano_codes": [
"ak111",
"ak252"
],
"volcano_count": 2,
"volcanoes": [
{
"alert_level": "WATCH",
"color_code": "ORANGE",
"headline": "AVO Great Sitkin ORANGE/WATCH - Slow eruption of lava continues within the summit crater associated with low-level seismicity.",
"image_url": "https://avo.alaska.edu/images/dbimages/display/1102983616_16_3.jpg",
"latitude": 52.0765,
"longitude": -176.1109,
"region": "Aleutians",
"summary": "Minor growth of the active lava dome within the summit crater was observed in satellite imagery over the past week. The southeast lava lobe is not advancing but lava continues to flow into it. The south flank of the dome is moving slowly southward and generating occasional small rockfalls. Elevated surface temperatures were observed in satellite views when ...",
"volcano_name": "Great Sitkin",
"volcano_number": "311120",
"volcano_url": "https://www.avo.alaska.edu/activity/GreatSitkin.php"
},
{
"alert_level": "ADVISORY",
"color_code": "YELLOW",
"headline": "AVO Shishaldin YELLOW/ADVISORY - Unrest continues with small earthquakes, tremor, and gas emissions.",
"image_url": "https://avo.alaska.edu/images/dbimages/display/1108075524_30_3.jpg",
"latitude": 54.7554,
"longitude": -163.9711,
"region": "Aleutians",
"summary": "Volcanic activity remains slightly elevated. Small earthquakes, ongoing tremor, and occasional infrasound signals have continued over the past week. During periods of clear weather, webcam views showed steaming from the summit area, and satellite data indicated minor sulfur dioxide emissions through much of the week. Overall, the frequency and magnitude of ...",
"volcano_name": "Shishaldin",
"volcano_number": "311360",
"volcano_url": "https://avo.alaska.edu/activity/Shishaldin.php"
}
],
"vona_url": null
}Get a volcano
Get one US volcano's details (location, elevation, threat category, USGS's description and links) with its current alert level, aviation color code and newest notice.
Inputs
- Volcano
volcanotextRequired - The volcano: pick one, or type its USGS code (such as hi3), its Smithsonian volcano number (such as 332010) or its name.
Outputs
alert_leveltext- The volcano alert level, for people on the ground: NORMAL, ADVISORY, WATCH or WARNING (UNASSIGNED when USGS doesn't monitor it closely enough to say).
color_codetext- The aviation color code: GREEN, YELLOW, ORANGE or RED (UNASSIGNED when USGS doesn't monitor it closely enough to say).
descriptiontext- USGS's description of the volcano and where to learn more, as plain text. Empty when USGS has none.
elevation_metersnumber- Its summit elevation in meters.
foundtrue/false- Whether USGS knows the volcano asked for.
icao_positiontext- Its position as aviation notices give it, such as 'N1925 W15517'.
image_urltext- A photo of the volcano.
latest_notice_identifiertext- The ID of the newest notice about the volcano. Empty when it is not monitored.
latest_notice_sent_attext- When the newest notice was sent, as an ISO 8601 date and time in UTC.
latest_notice_urltext- The newest notice's page on the USGS site.
latitudenumber- Its latitude in decimal degrees.
longitudenumber- Its longitude in decimal degrees.
monitoredtrue/false- Whether USGS currently monitors it and gives it an alert level.
observatory_codetext- The code of the USGS observatory that watches it, such as 'hvo'. The Observatory fields take it.
observatory_nametext- The observatory's name, such as 'Hawaiian Volcano Observatory'.
page_urltext- The volcano's notices page on the USGS site.
regiontext- Where it is, such as 'Hawaii' or 'Alaska - Aleutians'.
threat_leveltext- Its threat category in the USGS National Volcanic Threat Assessment: 'Very High Threat', 'High Threat', 'Moderate Threat', 'Low Threat' or 'Very Low Threat'. Empty when not yet assessed.
volcano_codetext- USGS's code for the volcano, such as 'hi3'. Every field that takes a volcano accepts it.
volcano_nametext- The volcano's name, such as 'Kilauea'.
volcano_numbertext- The volcano's Smithsonian volcano number, such as '332010'. Empty for an area such as 'Cascade Range'. Every field that takes a volcano accepts it.
volcano_urltext- The observatory's page about the volcano.
Example output
{
"alert_level": "ADVISORY",
"color_code": "YELLOW",
"description": "More Information:\nK\u012blauea activity summary also available by phone: (808) 967-8862\nK\u012blauea webcam images: https://www.usgs.gov/volcanoes/kilauea/webcams\nK\u012blauea photos/video: https://www.usgs.gov/volcanoes/kilauea/photo-and-video-chronology\nK\u012blauea lava-flow maps: https://www.usgs.gov/volcanoes/kilauea/maps\nK\u012blauea FAQs ...",
"elevation_meters": 1247,
"found": true,
"icao_position": "N1925 W15517",
"image_url": "https://volcanoes.usgs.gov/vsc/images/kilauea/kilauea.jpg",
"latest_notice_identifier": "DOI-USGS-HVO-2026-10-23T17:13:15+00:00",
"latest_notice_sent_at": "2026-10-23T19:37:45Z",
"latest_notice_url": "https://volcanoes.usgs.gov/hans-public/notice/DOI-USGS-HVO-2026-10-23T17:13:15+00:00",
"latitude": 19.421,
"longitude": -155.287,
"monitored": true,
"observatory_code": "hvo",
"observatory_name": "Hawaiian Volcano Observatory",
"page_url": "https://volcanoes.usgs.gov/hans-public/volcano/hi3",
"region": "Hawaii",
"threat_level": "Very High Threat",
"volcano_code": "hi3",
"volcano_name": "Kilauea",
"volcano_number": "332010",
"volcano_url": "https://www.usgs.gov/volcanoes/kilauea"
}Get a volcano's newest notice
Get the newest notice USGS has sent about a volcano, in full: every volcano it covers with its level, headline and summary, the section about the volcano asked for, and the whole notice as plain text.
Inputs
- Volcano
volcanotextRequired - The volcano, or an area such as Cascade Range: pick one, or type its USGS code (such as hi3), Smithsonian volcano number or name.
Outputs
categorytext- 'Event Response / Information Statement' or 'Scheduled Update'.
foundtrue/false- Whether USGS has sent a notice about the volcano.
highest_alert_leveltext- The highest alert level the notice gives.
highest_color_codetext- The highest aviation color code the notice gives.
notice_identifiertext- The notice's ID, such as 'DOI-USGS-HVO-2026-10-17T19:56:12+00:00'. 'Get a notice' takes it.
notice_typetext- The kind of notice, such as 'Daily Update'.
notice_type_codetext- The notice type's code: VAN (activity notification), VV (aviation notice, VONA), SR (status report), IS (information statement), DU, WU, BU or MU (daily, weekly, biweekly or monthly update).
notice_urltext- The notice's page on the USGS site.
observatory_codetext- The code of the USGS observatory that watches it, such as 'hvo'. The Observatory fields take it.
observatory_nametext- The observatory's name, such as 'Hawaiian Volcano Observatory'.
sent_attext- When the notice was sent, as an ISO 8601 date and time in UTC.
texttext- The whole notice as plain text, a line per paragraph, ready to send on.
titletext- The notice's title, such as 'HAWAIIAN VOLCANO OBSERVATORY DAILY UPDATE'.
volcanoobject- The notice's section about the volcano asked for. Empty when the notice covers several and none matches.
volcano_codeslist- USGS's codes for the volcanoes the notice covers.
volcano_countnumber- How many volcanoes or areas the notice covers.
volcanoeslist- A section per volcano or area, in the notice's order.
vona_urltext- The aviation notice's (VONA's) page on the USGS site, when the notice is one; otherwise empty.
Example output
{
"category": "Scheduled Update",
"found": true,
"highest_alert_level": "ADVISORY",
"highest_color_code": "YELLOW",
"notice_identifier": "DOI-USGS-HVO-2026-10-23T17:13:15+00:00",
"notice_type": "Daily Update",
"notice_type_code": "DU",
"notice_url": "https://volcanoes.usgs.gov/hans-public/notice/DOI-USGS-HVO-2026-10-23T17:13:15+00:00",
"observatory_code": "hvo",
"observatory_name": "Hawaiian Volcano Observatory",
"sent_at": "2026-10-23T19:37:45Z",
"text": "HAWAIIAN VOLCANO OBSERVATORY DAILY UPDATE\n\nU.S. Geological Survey\n\nFriday, October 23, 2026, 9:37 AM HST (Friday, October 23, 2026, 19:37 UTC)\n\nKILAUEA (VNUM #332010)\n19\u00b025'16\" N 155\u00b017'13\" W, Summit Elevation 4091 ft (1247 m)\nCurrent Volcano Alert Level: ADVISORY\nCurrent Aviation Color Code: YELLOW\n\nSummary: The Halema'uma'u eruption of K\u012blauea is ...",
"title": "HAWAIIAN VOLCANO OBSERVATORY DAILY UPDATE",
"volcano": {
"alert_level": "ADVISORY",
"color_code": "YELLOW",
"headline": "HVO Kilauea YELLOW/ADVISORY - The Halema'uma'u eruption of K\u012blauea is currently paused after episode 55 fountaining ended on October 17. Summit reinflation continues today and the preliminary forecast for episode 56 fountaining is between October 29 and November 5, 2026.",
"image_url": "https://volcanoes.usgs.gov/vsc/images/kilauea/kilauea.jpg",
"latitude": 19.421,
"longitude": -155.287,
"region": "Hawaii",
"summary": "Overview:\n\nThe summit eruption of K\u012blauea in Halema\u02bbuma\u02bbu is paused following lava fountaining in episode 55 on October 17, 2026. Summit tiltmeter data showed re-inflation began immediately following the end of episode 55 and steady, slow inflation is continuing. Assuming magma chamber inflation has returned to the pattern established in the past, the ...",
"volcano_name": "Kilauea",
"volcano_number": "332010",
"volcano_url": "https://www.usgs.gov/volcanoes/kilauea"
},
"volcano_codes": [
"hi3"
],
"volcano_count": 1,
"volcanoes": [
{
"alert_level": "ADVISORY",
"color_code": "YELLOW",
"headline": "HVO Kilauea YELLOW/ADVISORY - The Halema'uma'u eruption of K\u012blauea is currently paused after episode 55 fountaining ended on October 17. Summit reinflation continues today and the preliminary forecast for episode 56 fountaining is between October 29 and November 5, 2026.",
"image_url": "https://volcanoes.usgs.gov/vsc/images/kilauea/kilauea.jpg",
"latitude": 19.421,
"longitude": -155.287,
"region": "Hawaii",
"summary": "Overview:\n\nThe summit eruption of K\u012blauea in Halema\u02bbuma\u02bbu is paused following lava fountaining in episode 55 on October 17, 2026. Summit tiltmeter data showed re-inflation began immediately following the end of episode 55 and steady, slow inflation is continuing. Assuming magma chamber inflation has returned to the pattern established in the past, the ...",
"volcano_name": "Kilauea",
"volcano_number": "332010",
"volcano_url": "https://www.usgs.gov/volcanoes/kilauea"
}
],
"vona_url": null
}Get an aviation notice (VONA)
Get a Volcano Observatory Notice for Aviation (VONA): the message as pilots and dispatchers get it, and its lines read out (position, current and previous color code, activity, ash cloud height and movement, remarks).
Inputs
- Notice ID
notice_idtextRequired - The aviation notice's ID, as 'List aviation notices (VONAs)' gives it, or its link on the USGS site. An activity notification sent with a VONA has the same ID.
Outputs
activity_statustext- What the volcano is doing, such as 'ERUPTION OCCURRED'.
alert_leveltext- The volcano alert level when it was sent.
areatext- The area, such as 'HAWAII'.
ash_cloud_heighttext- The volcanic ash cloud's height, such as '12000FT AMSL', or why there is none.
ash_cloud_height_sourcetext- How the height was found, such as 'SATELLITE' or 'WEBCAM'.
ash_cloud_movementtext- Which way the ash cloud is moving, such as 'NW'.
color_codetext- The current aviation color code.
contacttext- Who to contact at the observatory.
eruption_durationtext- How long it lasted, such as '1 MIN', or 'NIL'.
eruption_onsettext- When the eruption began, such as '20261001/1527Z', or 'NIL' or 'UNKNOWN'.
foundtrue/false- Whether this notice has an aviation notice (VONA).
issued_attext- When the VONA was issued (its DTG line), as an ISO 8601 date and time in UTC.
next_noticetext- When the next aviation notice will come.
notice_identifiertext- The notice's ID.
notice_numbertext- The VONA's number for the year, such as '2026/69'.
notice_urltext- The notice's page on the USGS site.
observatory_codetext- The code of the USGS observatory that watches it, such as 'hvo'. The Observatory fields take it.
observatory_nametext- The observatory's name, such as 'Hawaiian Volcano Observatory'.
positiontext- The volcano's position, such as 'N1925 W15517'.
previous_color_codetext- The aviation color code before this notice.
remarkstext- The observatory's remarks.
source_elevationtext- The vent's or summit's elevation, such as '4091FT AMSL'.
texttext- The whole VONA message, line for line.
titletext- The notice's title.
volcano_nametext- The volcano, in capitals as the VONA gives it.
volcano_numbertext- The volcano's Smithsonian volcano number, such as '332010'. Empty for an area such as 'Cascade Range'. Every field that takes a volcano accepts it.
vona_urltext- The aviation notice's page on the USGS site.
Example output
{
"activity_status": "ERUPTION OCCURRED",
"alert_level": "ADVISORY",
"area": "ALASKA",
"ash_cloud_height": "UNKNOWN",
"ash_cloud_height_source": "SATELLITE",
"ash_cloud_movement": "UNKNOWN",
"color_code": "YELLOW",
"contact": "AVO DUTY SCIENTIST 907-786-7497",
"eruption_duration": "1 MIN",
"eruption_onset": "20261001/1527Z",
"found": true,
"issued_at": "2026-10-01T16:42:00Z",
"next_notice": "A NEW VONA WILL BE ISSUED IF COND CHANGE SIGNIFICANTLY OR IF THE COLOR CODE CHANGES",
"notice_identifier": "DOI-USGS-AVO-2026-10-01T15:57:08+00:00",
"notice_number": "2026/01",
"notice_url": "https://volcanoes.usgs.gov/hans-public/notice/DOI-USGS-AVO-2026-10-01T15:57:08+00:00",
"observatory_code": "avo",
"observatory_name": "Alaska Volcano Observatory",
"position": "N5147 W17848",
"previous_color_code": "GREEN",
"remarks": "A SINGLE BRIEF EXPLOSION DETECTED IN GEOPHYSICAL DATA. UNKNOWN IF VA CLOUD WAS PRODUCTED, BUT IF SO, EMMISSIONS WOULD BE MINOR DUE TO THE SHORT DURATION OF THE EXPLOSION. NOTHING SEEN IN SATELLITE DATA WITH MET CLOUD TOPS AT 20,000 AMSL",
"source_elevation": "5161FT AMSL",
"text": "WMAK01 PAVO 011642\nVONA\nDTG: 20261001/1642Z\nVOLCANO: GARELOI 311070\nPSN: N5147 W17848\nAREA: ALASKA\nSOURCE ELEV: 5161FT AMSL\nNOTICE NR: 2026/01\nCURRENT COLOUR CODE: YELLOW\nPREVIOUS COLOUR CODE: GREEN\nSVO: ALASKA VOLCANO OBSERVATORY\nACT STS: ERUPTION OCCURRED\nONSET: 20261001/1527Z\nDUR: 1 MIN\nVA CLD HGT: UNKNOWN\nHGT SOURCE: SATELLITE\nMOV: UNKNOWN\nCTC: AVO DUTY SCIENTIST 907-786-7497\nRMK: A SINGLE BRIEF EXPLOSION DETECTED IN GEOPHYSICAL DATA. UNKNOWN IF VA CLOUD WAS\n PRODUCTED, BUT IF SO, EMMISSIONS WOULD BE MINOR DUE TO THE SHORT DURATION OF THE\n EXPLOSION. NOTHING SEEN IN SATELLITE DATA WITH MET CLOUD TOPS AT 20,000 AMSL\nNXT NOTICE: A NEW VONA WILL BE ISSUED IF COND CHANGE SIGNIFICANTLY OR IF THE COLOR CODE CHANGES\nNNNN",
"title": "ALASKA VOLCANO OBSERVATORY VOLCANO OBSERVATORY NOTICE FOR AVIATION",
"volcano_name": "GARELOI",
"volcano_number": "311070",
"vona_url": "https://volcanoes.usgs.gov/hans-public/vona/DOI-USGS-AVO-2026-10-01T15:57:08+00:00"
}List aviation notices (VONAs)
List the Volcano Observatory Notices for Aviation (VONAs) sent in the last year, newest first, with the volcano, its location, the color code set and a one-line summary. Narrow them by observatory, volcano and how many days back.
Inputs
- Observatory
observatorytext - Only aviation notices from this USGS volcano observatory. Leave empty for all six.
- Volcano
volcanotext - Only aviation notices about this volcano: pick one, or type its USGS code, Smithsonian volcano number or name.
- Sent in the last (days)
daysnumber - Only aviation notices sent in this many days, up to 366. Leave empty for all 366.From 1 to 366.
Outputs
countnumber- How many aviation notices are listed.
noticeslist- Each aviation notice, newest first.
Example output
{
"count": 2,
"notices": [
{
"alert_level": "ADVISORY",
"color_code": "YELLOW",
"latitude": 19.421,
"longitude": -155.287,
"notice_identifier": "DOI-USGS-HVO-2026-10-17T19:56:12+00:00",
"notice_url": "https://volcanoes.usgs.gov/hans-public/notice/DOI-USGS-HVO-2026-10-17T19:56:12+00:00",
"observatory_code": "hvo",
"observatory_name": "Hawaiian Volcano Observatory",
"region": "Hawaii",
"sent_at": "2026-10-17T19:59:31Z",
"synopsis": "HVO Kilauea YELLOW/ADVISORY - Episode 55 of the ongoing Halema\u02bbuma\u02bbu eruption ended abruptly at 9:03 a.m. HST on October 17, 2026. VAN is being reissued to drop the alert level from WATCH to ADVISORY and the color code from ORANGE to YELLOW.",
"threat_level": "Very High Threat",
"volcano_code": "hi3",
"volcano_name": "Kilauea",
"volcano_number": "332010",
"vona_url": "https://volcanoes.usgs.gov/hans-public/vona/DOI-USGS-HVO-2026-10-17T19:56:12+00:00"
},
{
"alert_level": "WATCH",
"color_code": "ORANGE",
"latitude": 19.421,
"longitude": -155.287,
"notice_identifier": "DOI-USGS-HVO-2026-10-17T19:04:00+00:00",
"notice_url": "https://volcanoes.usgs.gov/hans-public/notice/DOI-USGS-HVO-2026-10-17T19:04:00+00:00",
"observatory_code": "hvo",
"observatory_name": "Hawaiian Volcano Observatory",
"region": "Hawaii",
"sent_at": "2026-10-17T19:11:46Z",
"synopsis": "HVO Kilauea ORANGE/WATCH - Episode 55 of the ongoing Halema\u02bbuma\u02bbu eruption ended abruptly at 9:03 a.m. HST on October 17, 2026.",
"threat_level": "Very High Threat",
"volcano_code": "hi3",
"volcano_name": "Kilauea",
"volcano_number": "332010",
"vona_url": "https://volcanoes.usgs.gov/hans-public/vona/DOI-USGS-HVO-2026-10-17T19:04:00+00:00"
}
]
}List CAP alerts
List the Common Alerting Protocol (CAP) alerts USGS issues for volcanoes at ORANGE/WATCH or higher, including a 'Cancel' when one drops back below. Each has its severity, urgency, certainty, expiry time and a link to the CAP document for alerting systems.
Inputs
None.
Outputs
alertslist- Each alert.
countnumber- How many alerts are listed.
Example output
{
"alerts": [
{
"alert_level": "WATCH",
"cap_url": "https://volcanoes.usgs.gov/hans-public/rss/cap/volcano/311120",
"certainty": "Likely",
"color_code": "ORANGE",
"contact": "avo-sci@usgs.gov",
"elevation_meters": 1740,
"expires_at": "2026-10-24T19:28:22Z",
"headline": "AVO Weekly Update 20261023_1128",
"latitude": 52.0765,
"longitude": -176.1109,
"message_type": "Alert",
"notice_identifier": "DOI-USGS-AVO-2026-10-23T18:32:10+00:00",
"notice_url": "https://volcanoes.usgs.gov/hans-public/notice/DOI-USGS-AVO-2026-10-23T18:32:10+00:00",
"observatory_name": "Alaska Volcano Observatory",
"previous_sent_at": "2021-05-27T20:58:06Z",
"sent_at": "2026-10-23T19:28:22Z",
"severity": "Minor",
"synopsis": "Slow eruption of lava continues within the summit crater associated with low-level seismicity.",
"urgency": "Expected",
"volcano_name": "Great Sitkin Volcano",
"volcano_number": "311120"
},
{
"alert_level": "ADVISORY",
"cap_url": "https://volcanoes.usgs.gov/hans-public/rss/cap/volcano/332010",
"certainty": "Possible",
"color_code": "YELLOW",
"contact": "askHVO@usgs.gov",
"elevation_meters": 1247,
"expires_at": "2026-10-24T19:37:45Z",
"headline": "HVO Daily Update 20261023_0937",
"latitude": 19.421,
"longitude": -155.287,
"message_type": "Cancel",
"notice_identifier": "DOI-USGS-HVO-2026-10-23T17:13:15+00:00",
"notice_url": "https://volcanoes.usgs.gov/hans-public/notice/DOI-USGS-HVO-2026-10-23T17:13:15+00:00",
"observatory_name": "Hawaiian Volcano Observatory",
"previous_sent_at": "2026-09-07T23:00:41Z",
"sent_at": "2026-10-23T19:37:45Z",
"severity": "Minor",
"synopsis": "The Halema'uma'u eruption of K\u012blauea is currently paused after episode 55 fountaining ended on October 17. Summit reinflation continues today and the preliminary forecast for episode 56 fountaining is between October 29 and November 5, 2026.",
"urgency": "Future",
"volcano_name": "Kilauea Volcano",
"volcano_number": "332010"
}
],
"count": 2
}List elevated volcanoes
List the US volcanoes above normal right now: alert level ADVISORY, WATCH or WARNING, or aviation color code YELLOW, ORANGE or RED. Each comes with its current and previous level, when it changed, USGS's one-line summary and the newest notice about it, highest level first.
Inputs
- Observatory
observatorytext - Only volcanoes from this USGS volcano observatory. Leave empty for all six.
Outputs
countnumber- How many volcanoes are listed.
highest_alert_leveltext- The highest alert level among them, such as 'WATCH'. Empty when none is elevated.
highest_color_codetext- The highest aviation color code among them, such as 'ORANGE'. Empty when none is elevated.
volcanoeslist- Each volcano above normal, highest level first.
Example output
{
"count": 3,
"highest_alert_level": "WATCH",
"highest_color_code": "ORANGE",
"volcanoes": [
{
"alert_level": "WATCH",
"color_code": "ORANGE",
"latest_notice_identifier": "DOI-USGS-AVO-2026-10-23T18:32:10+00:00",
"latest_notice_sent_at": "2026-10-23T19:28:22Z",
"latest_notice_type": "Weekly Update",
"latest_notice_type_code": "WU",
"latest_notice_url": "https://volcanoes.usgs.gov/hans-public/notice/DOI-USGS-AVO-2026-10-23T18:32:10+00:00",
"observatory_code": "avo",
"observatory_name": "Alaska Volcano Observatory",
"previous_alert_level": "ADVISORY",
"previous_color_code": "YELLOW",
"status_since": "2021-07-23T22:25:55Z",
"synopsis": "Slow eruption of lava continues within the summit crater associated with low-level seismicity.",
"volcano_name": "Great Sitkin",
"volcano_number": "311120"
},
{
"alert_level": "ADVISORY",
"color_code": "YELLOW",
"latest_notice_identifier": "DOI-USGS-NMI-2026-10-22T23:13:02+00:00",
"latest_notice_sent_at": "2026-10-22T23:16:38Z",
"latest_notice_type": "Weekly Update",
"latest_notice_type_code": "WU",
"latest_notice_url": "https://volcanoes.usgs.gov/hans-public/notice/DOI-USGS-NMI-2026-10-22T23:13:02+00:00",
"observatory_code": "nmi",
"observatory_name": "Northern Mariana Islands",
"previous_alert_level": "UNASSIGNED",
"previous_color_code": "UNASSIGNED",
"status_since": "2026-07-16T00:13:50Z",
"synopsis": "Plumes of discolored water seen in satellite imagery; no significant geophysical signals.",
"volcano_name": "Ahyi Seamount",
"volcano_number": "284141"
},
{
"alert_level": "ADVISORY",
"color_code": "YELLOW",
"latest_notice_identifier": "DOI-USGS-HVO-2026-10-23T17:13:15+00:00",
"latest_notice_sent_at": "2026-10-23T19:37:45Z",
"latest_notice_type": "Daily Update",
"latest_notice_type_code": "DU",
"latest_notice_url": "https://volcanoes.usgs.gov/hans-public/notice/DOI-USGS-HVO-2026-10-23T17:13:15+00:00",
"observatory_code": "hvo",
"observatory_name": "Hawaiian Volcano Observatory",
"previous_alert_level": "WATCH",
"previous_color_code": "ORANGE",
"status_since": "2026-10-17T19:59:31Z",
"synopsis": "The Halema'uma'u eruption of K\u012blauea is currently paused after episode 55 fountaining ended on October 17. Summit reinflation continues today and the preliminary forecast for episode 56 fountaining is between October 29 and November 5, 2026.",
"volcano_name": "Kilauea",
"volcano_number": "332010"
}
]
}List monitored volcanoes
List every volcano USGS monitors closely enough to give an alert level, with its alert level, aviation color code and newest notice, and how many are at each level. Narrow it to one observatory or to some alert levels.
Inputs
- Observatory
observatorytext - Only volcanoes from this USGS volcano observatory. Leave empty for all six.
- Alert levels
alert_levelslist - Only volcanoes at any of these alert levels. Leave empty for every level.One or more of:
NORMAL,ADVISORY,WATCH,WARNING.
Outputs
alert_level_countsobject- How many listed volcanoes are at each alert level.
color_code_countsobject- How many listed volcanoes are at each aviation color code.
countnumber- How many volcanoes are listed.
highest_alert_leveltext- The highest alert level among them. Empty when none is listed.
highest_color_codetext- The highest aviation color code among them. Empty when none is listed.
volcanoeslist- Each monitored volcano, highest level first, then by name.
Example output
{
"alert_level_counts": {
"advisory": 1,
"normal": 1,
"warning": 0,
"watch": 1
},
"color_code_counts": {
"green": 1,
"orange": 1,
"red": 0,
"yellow": 1
},
"count": 3,
"highest_alert_level": "WATCH",
"highest_color_code": "ORANGE",
"volcanoes": [
{
"alert_level": "WATCH",
"color_code": "ORANGE",
"latest_notice_identifier": "DOI-USGS-AVO-2026-10-23T18:32:10+00:00",
"latest_notice_sent_at": "2026-10-23T19:28:22Z",
"latest_notice_type": "Weekly Update",
"latest_notice_type_code": "WU",
"latest_notice_url": "https://volcanoes.usgs.gov/hans-public/notice/DOI-USGS-AVO-2026-10-23T18:32:10+00:00",
"observatory_code": "avo",
"observatory_name": "Alaska Volcano Observatory",
"volcano_code": "ak111",
"volcano_name": "Great Sitkin",
"volcano_number": "311120"
},
{
"alert_level": "ADVISORY",
"color_code": "YELLOW",
"latest_notice_identifier": "DOI-USGS-AVO-2026-10-23T18:32:10+00:00",
"latest_notice_sent_at": "2026-10-23T19:28:22Z",
"latest_notice_type": "Weekly Update",
"latest_notice_type_code": "WU",
"latest_notice_url": "https://volcanoes.usgs.gov/hans-public/notice/DOI-USGS-AVO-2026-10-23T18:32:10+00:00",
"observatory_code": "avo",
"observatory_name": "Alaska Volcano Observatory",
"volcano_code": "ak252",
"volcano_name": "Shishaldin",
"volcano_number": "311360"
},
{
"alert_level": "NORMAL",
"color_code": "GREEN",
"latest_notice_identifier": "DOI-USGS-AVO-2019-09-04T15:47:55-08:00",
"latest_notice_sent_at": "2019-09-06T18:29:39Z",
"latest_notice_type": "Information Statement",
"latest_notice_type_code": "IS",
"latest_notice_url": "https://volcanoes.usgs.gov/hans-public/notice/DOI-USGS-AVO-2019-09-04T15:47:55-08:00",
"observatory_code": "avo",
"observatory_name": "Alaska Volcano Observatory",
"volcano_code": "ak6",
"volcano_name": "Akutan",
"volcano_number": "311320"
}
]
}List observatories
List the six USGS volcano observatories with their contact address and how many notices of each kind each has sent, with the first and latest.
Inputs
None.
Outputs
countnumber- How many observatories are listed.
observatorieslist- Each USGS volcano observatory.
Example output
{
"count": 2,
"observatories": [
{
"email": "avo-sci@usgs.gov",
"first_notice_sent_at": "2008-03-28T01:44:33Z",
"full_name": "Alaska Volcano Observatory",
"last_notice_sent_at": "2026-10-23T19:28:22Z",
"name": "Alaska",
"notice_types": [
{
"first_sent_at": "2009-01-10T21:16:58Z",
"last_sent_at": "2026-10-22T19:49:57Z",
"notice_type": "Daily Update",
"notice_type_code": "DU",
"total": 4454
},
{
"first_sent_at": "2008-03-28T01:44:33Z",
"last_sent_at": "2020-01-20T02:12:58Z",
"notice_type": "Status Report",
"notice_type_code": "SR",
"total": 1010
},
{
"first_sent_at": "2008-03-28T02:33:21Z",
"last_sent_at": "2026-10-23T19:28:22Z",
"notice_type": "Weekly Update",
"notice_type_code": "WU",
"total": 971
}
],
"notices_sent": 7780,
"observatory_code": "avo"
},
{
"email": "CaliforniaVolcanoObservatory@usgs.gov",
"first_notice_sent_at": "2006-12-05T17:37:28Z",
"full_name": "California Volcano Observatory",
"last_notice_sent_at": "2026-10-20T16:43:29Z",
"name": "California",
"notice_types": [
{
"first_sent_at": "2006-12-05T17:37:28Z",
"last_sent_at": "2010-01-21T18:10:02Z",
"notice_type": "Daily Update",
"notice_type_code": "DU",
"total": 504
},
{
"first_sent_at": "2007-06-20T22:07:35Z",
"last_sent_at": "2019-07-11T23:36:44Z",
"notice_type": "Information Statement",
"notice_type_code": "IS",
"total": 490
},
{
"first_sent_at": "2010-01-22T20:56:16Z",
"last_sent_at": "2026-10-20T16:43:29Z",
"notice_type": "Weekly Update",
"notice_type_code": "WU",
"total": 432
}
],
"notices_sent": 1531,
"observatory_code": "calvo"
}
]
}List recent notices
List the notices USGS volcano observatories sent in the last month, newest first, narrowed by observatory, notice type and how many days back. Each comes with the volcanoes it covers and its link; 'Get a notice' reads one in full.
Inputs
- Observatory
observatorytext - Only notices from this USGS volcano observatory. Leave empty for all six.
- Notice types
notice_typeslist - Only notices of any of these types. An activity notification sent with its notice for aviation counts as both. Leave empty for every type.One or more of:
VAN(Volcano activity notification (VAN)),VV(Notice for aviation (VONA)),SR(Status report),IS(Information statement),DU(Daily update),WU(Weekly update),BU(Biweekly update),MU(Monthly update). - Sent in the last (days)
daysnumber - Only notices sent in this many days, up to 31. Leave empty for all 31.From 1 to 31.
Outputs
countnumber- How many notices are listed.
noticeslist- Each notice, newest first.
Example output
{
"count": 3,
"notices": [
{
"category": "Scheduled Update",
"notice_identifier": "DOI-USGS-HVO-2026-10-23T17:13:15+00:00",
"notice_type": "Daily Update",
"notice_type_code": "DU",
"notice_url": "https://volcanoes.usgs.gov/hans-public/notice/DOI-USGS-HVO-2026-10-23T17:13:15+00:00",
"observatory_code": "hvo",
"observatory_name": "Hawaiian Volcano Observatory",
"sent_at": "2026-10-23T19:37:45Z",
"volcanoes": [
"Kilauea"
],
"vona_url": null
},
{
"category": "Scheduled Update",
"notice_identifier": "DOI-USGS-AVO-2026-10-23T18:32:10+00:00",
"notice_type": "Weekly Update",
"notice_type_code": "WU",
"notice_url": "https://volcanoes.usgs.gov/hans-public/notice/DOI-USGS-AVO-2026-10-23T18:32:10+00:00",
"observatory_code": "avo",
"observatory_name": "Alaska Volcano Observatory",
"sent_at": "2026-10-23T19:28:22Z",
"volcanoes": [
"Great Sitkin",
"Shishaldin"
],
"vona_url": null
},
{
"category": "Scheduled Update",
"notice_identifier": "DOI-USGS-CVO-2026-10-23T14:05:07+00:00",
"notice_type": "Weekly Update",
"notice_type_code": "WU",
"notice_url": "https://volcanoes.usgs.gov/hans-public/notice/DOI-USGS-CVO-2026-10-23T14:05:07+00:00",
"observatory_code": "cvo",
"observatory_name": "Cascades Volcano Observatory",
"sent_at": "2026-10-23T18:11:41Z",
"volcanoes": [
"Cascade Range"
],
"vona_url": null
}
]
}List US volcanoes
List every volcano of the United States with its location, elevation, threat category and links, narrowed by observatory, threat category, or words in the name or region.
Inputs
- Observatory
observatorytext - Only volcanoes from this USGS volcano observatory. Leave empty for all six.
- Threat levels
threat_levelslist - Only volcanoes in any of these categories of the USGS National Volcanic Threat Assessment. Leave empty for all.One or more of:
very_high(Very High Threat),high(High Threat),moderate(Moderate Threat),low(Low Threat),very_low(Very Low Threat). - Name or region
nametext - Only volcanoes whose name or region contains these words, such as 'Mauna' or 'Oregon'.
Outputs
countnumber- How many volcanoes are listed.
volcanoeslist- Each volcano, by observatory and name.
Example output
{
"count": 2,
"volcanoes": [
{
"elevation_meters": 1247,
"icao_position": "N1925 W15517",
"image_url": "https://volcanoes.usgs.gov/vsc/images/kilauea/kilauea.jpg",
"latitude": 19.421,
"longitude": -155.287,
"observatory_code": "hvo",
"observatory_name": "Hawaiian Volcano Observatory",
"page_url": "https://volcanoes.usgs.gov/hans-public/volcano/hi3",
"region": "Hawaii",
"threat_level": "Very High Threat",
"volcano_code": "hi3",
"volcano_name": "Kilauea",
"volcano_number": "332010",
"volcano_url": "https://www.usgs.gov/volcanoes/kilauea"
},
{
"elevation_meters": 4170,
"icao_position": "N1929 W15536",
"image_url": "https://volcanoes.usgs.gov/vsc/images/mauna_loa/mauna_loa.jpg",
"latitude": 19.475,
"longitude": -155.608,
"observatory_code": "hvo",
"observatory_name": "Hawaiian Volcano Observatory",
"page_url": "https://volcanoes.usgs.gov/hans-public/volcano/hi6",
"region": "Hawaii",
"threat_level": "Very High Threat",
"volcano_code": "hi6",
"volcano_name": "Mauna Loa",
"volcano_number": "332020",
"volcano_url": "https://www.usgs.gov/volcanoes/mauna-loa"
}
]
}Search notices
Search every notice USGS volcano observatories have sent since 2006 by observatory, volcano, notice type, date range and words in the text, newest first, 20 a page. Each comes with its one-line summaries and link.
Inputs
- Observatory
observatorytext - Only notices from this USGS volcano observatory. Leave empty for all six.
- Volcano
volcanotext - Only notices about this volcano or area: pick one, or type its USGS code, Smithsonian volcano number or name.
- Notice type
notice_typetext - Only notices of this type. Leave empty for every type.One of:
VAN(Volcano activity notification (VAN)),VV(Notice for aviation (VONA)),SR(Status report),IS(Information statement),DU(Daily update),WU(Weekly update),BU(Biweekly update),MU(Monthly update). - Sent on or after
sent_afterdate - Only notices sent on or after this day (UTC).
- Sent on or before
sent_beforedate - Only notices sent on or before this day (UTC).
- Contains text
texttext - Only notices whose text contains this exact phrase, in any case, such as 'lava fountain'.
- Page
pagenumber - Which page of 20 results to return, from 1.From 1 to 2000. Default:
1.
Outputs
countnumber- How many notices are on this page.
more_availabletrue/false- Whether a later page has more matches.
noticeslist- Each matching notice, newest first.
pagenumber- The page returned, from 1.
totalnumber- How many notices match, on every page.
total_pagesnumber- How many pages of 20 the matches fill.
Example output
{
"count": 2,
"more_available": false,
"notices": [
{
"headlines": [
"Episode 55 of the ongoing Halema\u02bbuma\u02bbu eruption ended abruptly at 9:03 a.m. HST on October 17, 2026. VAN is being reissued to drop the alert level from WATCH to ADVISORY and the color code from ORANGE to YELLOW."
],
"notice_identifier": "DOI-USGS-HVO-2026-10-17T19:56:12+00:00",
"notice_type": "Volcano Activity Notification",
"notice_type_code": "VAN",
"notice_url": "https://volcanoes.usgs.gov/hans-public/notice/DOI-USGS-HVO-2026-10-17T19:56:12+00:00",
"observatory_code": "hvo",
"observatory_name": "Hawaiian Volcano Observatory",
"sent_at": "2026-10-17T19:59:31Z",
"volcano_codes": [
"hi3"
],
"vona_url": null
},
{
"headlines": [
"Episode 55 of the ongoing Halema\u02bbuma\u02bbu eruption ended abruptly at 9:03 a.m. HST on October 17, 2026."
],
"notice_identifier": "DOI-USGS-HVO-2026-10-17T19:04:00+00:00",
"notice_type": "Volcano Activity Notification",
"notice_type_code": "VAN",
"notice_url": "https://volcanoes.usgs.gov/hans-public/notice/DOI-USGS-HVO-2026-10-17T19:04:00+00:00",
"observatory_code": "hvo",
"observatory_name": "Hawaiian Volcano Observatory",
"sent_at": "2026-10-17T19:11:46Z",
"volcano_codes": [
"hi3"
],
"vona_url": null
}
],
"page": 1,
"total": 6,
"total_pages": 1
}