---
title: "List Global Volcanic Eruptions records"
method: GET
path: "/v1/data/global-volcanic-eruptions"
tags: ["Volcanic Eruptions"]
---

# List Global Volcanic Eruptions records

`GET /v1/data/global-volcanic-eruptions`

## Request

- Base URL: `https://api.aristocles.com.au` (the document declares no server; this is the origin it was published from)
- URL: `https://api.aristocles.com.au/v1/data/global-volcanic-eruptions`
- Auth: none declared. Required headers: `X-API-Key`

List Global Volcanic Eruptions records with optional filters and pagination.

**Source:** Source: NOAA National Centers for Environmental Information, Significant Volcanic Eruption Database (public domain). (Public Domain (U.S. Government Work)).

**Fields returned:**
- `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

**Example:** `GET /v1/data/global-volcanic-eruptions?limit=10&country=example`

## Query parameters

- `limit` integer: Max records to return (1-100).
- `offset` integer: Records to skip, for pagination.
- `country` string, nullable: Country in which the volcano sits
- `year` string, nullable: Year of the eruption; negative values indicate BCE
- `explosivity_index` string, nullable: Volcanic Explosivity Index from 0 to 8
- `morphology` string, nullable: Volcano type, e.g. stratovolcano, caldera, shield

## Headers

- `X-API-Key` string, required

## Response `200`

A page of Global Volcanic Eruptions records with pagination metadata.

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/aristocles/apis/aristocles-data-api.md) · [All operations](https://skmtc.dev/aristocles/apis/aristocles-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/aristocles/apis/aristocles-data-api/revisions/4ca3fbb73c59?raw)