USGS Volcano Message API

Volcano messages are quick and short peices of information we display on web pages during eruptions.

At the time of this writing, only Kilauea, vnum = 332010, has messages.

The vnum parameter is the value assigned by the Smithsonian Institution's Global Volcanism Program and can be found here: https://volcanoes.usgs.gov/vsc/api/volcanoApi/volcanoesUS.

Get the newest message for a volcano:
https://volcanoes.usgs.gov/vsc/api/volcanoMessageApi/volcanoNewest/{vnum}
Get the newest message for a volcano.

Get recent messages for a volcano:
https://volcanoes.usgs.gov/vsc/api/volcanoMessageApi/volcanoRecent/{vnum}
Or https://volcanoes.usgs.gov/vsc/api/volcanoMessageApi/volcanoRecent/{vnum}?limit={integer value} where limit is the number of messages returned, most recent first.
Or https://volcanoes.usgs.gov/vsc/api/volcanoMessageApi/volcanoRecent/{vnum}?daysBack={integer value} where daysBack returns any messages sent between now and that number of days ago.


These items are freely available but are designed to support USGS applications. No guarantee of continuing support should be assumed.

Please contact mjrandall@usgs.gov with questions or concerns.