Environment

Eruption events

Historical eruption events from NOAA with VEI (Volcanic Explosivity Index), deaths, damage in $M, houses destroyed. Filter by country, year range, VEI.

get/api/v1/volcanoes/eruptions

Query parameters

countrystring

Country code (ISO 3166-1 alpha-2/alpha-3) or slug.

Country code (ISO 3166-1 alpha-2/alpha-3) or slug.

min_yearinteger

Minimum year.

Minimum year.

max_yearinteger

Maximum year.

Maximum year.

min_veiinteger

Minimum Volcanic Explosivity Index (0-7).

Minimum Volcanic Explosivity Index (0-7).

significantboolean

Only significant eruptions.

Only significant eruptions.

limitinteger

Maximum number of records to return.

Maximum number of records to return.

Response

NOAA volcanic eruption events with VEI, deaths, and damage estimates.

Example response

{
  "meta": {
    "endpoint": "/api/v1/fred/us/cpi",
    "data_time": "2026-04-16T14:30:00Z",
    "response_time": "2026-04-16T14:30:12Z",
    "provider": "Sugra API v1.0.1",
    "data_age_days": 8.532,
    "source": "sugra_crypto",
    "attribution": "Short interest and Reg SHO daily short volume data is owned by and sourced from FINRA (Financial Industry Regulatory Authority).",
    "fallback_chain": [
      "sugra_crypto",
      "sugra_finance"
    ],
    "period": "2026-Q1",
    "notes": "the UKMTO report behind these counts is dated 2026-08-21 and is 11 days old"
  }
}

Changes

Changed in 3 of the 22 revisions of this API.615

    • added the optional property meta/data_age_days to the response with the 200 status

      response-optional-property-added

    • added the optional property meta/notes to the response with the 200 status

      response-optional-property-added

    • added the optional property meta/period to the response with the 200 status

      response-optional-property-added

    • the response property data/count became optional for the status 200

      response-property-became-optional

    • the response property data/eruptions became optional for the status 200

      response-property-became-optional

    • the response property data/total became optional for the status 200

      response-property-became-optional

    • response property data/count list-of-types was widened by adding types null and number to media type application/json of response 200

      response-property-list-of-types-widened

    • response property data/eruptions list-of-types was widened by adding types null to media type application/json of response 200

      response-property-list-of-types-widened

    • response property data/total list-of-types was widened by adding types null and number to media type application/json of response 200

      response-property-list-of-types-widened

    This revision also has 15 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

    • added the optional property code to the response with the 401 status

      response-optional-property-added

    • added the optional property code to the response with the 429 status

      response-optional-property-added

    • added the optional property code to the response with the 503 status

      response-optional-property-added

    • added the optional property hint to the response with the 401 status

      response-optional-property-added

    • added the optional property hint to the response with the 429 status

      response-optional-property-added

    • added the optional property hint to the response with the 503 status

      response-optional-property-added

    • added the optional property plan to the response with the 401 status

      response-optional-property-added

    • added the optional property plan to the response with the 429 status

      response-optional-property-added

    • added the optional property plan to the response with the 503 status

      response-optional-property-added

    • added the optional property reason to the response with the 401 status

      response-optional-property-added

    • added the optional property reason to the response with the 429 status

      response-optional-property-added

    • added the optional property reason to the response with the 503 status

      response-optional-property-added