Hazard Notification System (HANS) API

Get Notice: https://volcanoes.usgs.gov/vsc/api/hansApi/notice/DOI-USGS-AVO-2019-02-24T12:03:55-09:00
Notice information based on notice identifier value. Notices may include several volcanoes.

Get Notice Section: https://volcanoes.usgs.gov/vsc/api/hansApi/noticeSection/DOI-USGS-AVO-2019-02-24T12:03:57-09:00
Notice information based on notice section identifier value. Notice sections are generally about a single volcano.

Get VONAs (Volcanic Activity Notices for Aviation): https://volcanoes.usgs.gov/vsc/api/hansApi/vonas
Or: https://volcanoes.usgs.gov/vsc/api/hansApi/vonas?obs={avo|calvo|cvo|hvo|nmi|yvo}
All Aviation Notices sent by the Volcano Hazards Program. Newest first.

Get Recent VONAs (Volcanic Activity Notices for Aviation): https://volcanoes.usgs.gov/vsc/api/hansApi/vonas/DAYS_OLD
Or: https://volcanoes.usgs.gov/vsc/api/hansApi/vonas/DAYS_OLD?obs={avo|calvo|cvo|hvo|nmi|yvo}
Recent Aviation Notices sent by the Volcano Hazards Program. Newest first. DAYS_OLD limits results to VONAs sent within that number of days.

Newest Notices From Each Observatory: https://volcanoes.usgs.gov/vsc/api/hansApi/newest
Or: https://volcanoes.usgs.gov/vsc/api/hansApi/newest?obs={avo|calvo|cvo|hvo|nmi|yvo}
Most recent notices from each observatory. Notices may include several volcanoes.

Newest Information Statement From Selected Observatory: https://volcanoes.usgs.gov/vsc/api/hansApi/newestIS?obs={avo|calvo|cvo|hvo|nmi|yvo}
Most recent Information Statement from selected observatory.

Newest Notice for a Volcano: https://volcanoes.usgs.gov/vsc/api/hansApi/volcNewest/311240
Most recent notice for a specific volcano based on Global Volcanism Program volcano number. Notices are generally only sent for elevated volcanoes.


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.