Global Volcanic Eruptions
A worldwide historical record of significant volcanic eruptions, with location, size and impact.
The long-running record of significant volcanic eruptions maintained by the United States national geophysical data centre, covering events from antiquity to the present. Each row gives the volcano name, date, coordinates, elevation, explosivity index and recorded human and economic impact. Insurers, travel-risk platforms and hazard modellers use it as a baseline for eruption frequency and severity.
Source: NOAA National Centers for Environmental Information — Significant Volcanic Eruption Database · Public Domain (U.S. Government Work) · Source: NOAA National Centers for Environmental Information, Significant Volcanic Eruption Database (public domain).
Endpoints
Every request is authenticated with your X-API-Key and counted against your plan.
- GET /v1/data/global-volcanic-eruptions
- GET /v1/data/global-volcanic-eruptions/search?q=...
- GET /v1/data/global-volcanic-eruptions/{key}
Base path /v1/data/global-volcanic-eruptions · full reference in the interactive docs. Also exposed as an MCP tool for AI agents.
Fields
| Field | Type | Description |
|---|---|---|
| event_id | int | Unique identifier for the eruption event |
| volcano_name | str | Name of the volcano |
| location | str | Descriptive location of the volcano |
| country | str | Country in which the volcano sits |
| year | int | Year of the eruption; negative values indicate BCE |
| month | int | Month of the eruption where known |
| day | int | Day of the eruption where known |
| latitude | float | Latitude in decimal degrees |
| longitude | float | Longitude in decimal degrees |
| elevation_m | int | Volcano summit elevation in metres |
| morphology | str | Volcano type, e.g. stratovolcano, caldera, shield |
| explosivity_index | int | Volcanic Explosivity Index from 0 to 8 |
| deaths_total | int | Total recorded deaths attributed to the eruption |
| damage_millions_usd | float | Recorded economic damage in millions of US dollars |
What you get
FAQ
- Does this include every eruption?
- No. It is a catalogue of significant eruptions — those causing deaths, damage, a high explosivity index, or a tsunami — not every minor event.
- Why are old records incomplete?
- Pre-modern events often lack month, day, casualty or damage figures. Those fields are returned as null rather than estimated.
- Can I use this commercially?
- Yes. The source is a United States government work in the public domain; we ask that you keep the attribution string.
- Is there real-time eruption alerting?
- No. This is a historical catalogue; new events are added as the source curates them, not within minutes.
Pricing
Simple, transparent pricing
Start free, upgrade when you need more. All plans include full API access.
Free
Get started and explore the API
- 100 API requests per day
- All endpoints included
- Community support
Pro
For production apps and AI agents
- 10,000 API requests per day
- All endpoints included
- Priority support
- Usage dashboard
Enterprise
Unlimited access for high-volume use
- Unlimited API requests
- All endpoints included
- Priority support
- Usage dashboard
- Dedicated support channel
Getting Started
Start building in minutes
Register for a free API key, make your first request, and upgrade when you're ready.
Register
Create an account to get your API key. It's free — no credit card required.
curl -X POST https://api.aristocles.com.au/v1/auth/register \
-H "Content-Type: application/json" \
-d '{"email": "you@example.com", "name": "Your Name"}'Make a request
Use your API key in the X-API-Key header to authenticate requests.
curl https://api.aristocles.com.au/v1/data/asx \
-H "X-API-Key: your_api_key_here"Upgrade
Need more requests? Upgrade to Pro or Enterprise — you'll be redirected to Stripe Checkout.
curl -X POST "https://api.aristocles.com.au/v1/billing/checkout?tier=pro" \
-H "X-API-Key: your_api_key_here"Check usage
Monitor your daily request count and remaining quota at any time.
curl https://api.aristocles.com.au/v1/usage \
-H "X-API-Key: your_api_key_here"