Near-real-time volcanic activity report from the United States based on the USGS report.

Limitation: Query time interval must be less than one minute. This will allow 1440 queries per day.

Resource URL

https://api.idemc.org/volcano_activity_us/v1/

Parameters

ParameterDescriptionOptionalDefault
api_key Authentication API key Required None
status Set the "eruption" keyword, if you need only the erupted and active volcanoes data True None

Example

Method: POST
URL: https://api.idemc.org/volcano_activity_us/v1/

Request

  {
    "api_key" : "xycvbnm234ztr"
    "status" : "eruption"
}  

Response

  {
    "type": "FeatureCollection",
    "metadata": {
        "generated": "Wed, 12 Aug 2020 09:32:41 +0000",
        "url": "https://api.idemc.org/volcano_activity_us/v1/",
        "title": "IDEMC - Volcano activity report in the US",
        "status": 200,
        "message": "Data has been published",
        "api": "1.0.4",
        "count": 168
    },
    "features": [
        {
            "id": "93",
            "type": "Feature",
            "geometry": {
                "type": "Point",
                "coordinates": [
                    "-119.032",
                    "37.631"
                ]
            },
            "properties": {
                "main_category": "Geological Event",
                "sub_category": "volcano activity",
                "main_category_code": "GE",
                "sub_category_code": "VAC",
                "event_date": "2019-11-15T14:54:30+00:00",
                "event_update": "2020-07-14T21:50:07+00:00",
                "volcano_number": "323150",
                "volcano_name": "Mammoth Mountain",
                "location": {
                    "area_code": "05",
                    "area_name": "North America",
                    "country_code": "5010",
                    "country_name": "United States",
                    "administration_area": "California",
                    "location": "California"
                },
                "actual_alert_level_id": 1,
                "actual_alert_level_name": "NORMAL",
                "actual_aviation_level_id": 1,
                "actual_aviation_level_name": "GREEN",
                "actual_threat_level_id": 3,
                "actual_threat_level_name": "Moderate Threat",
                "data_confidence": 1
            }
        }
 }  

Error Response

  {
    "type": "FeatureCollection",
    "metadata": {
        "generated": "Mon, 25 Nov 2019 16:15:54 +0000",
        "url": "https://api.idemc.org/volcano_activity_us/v1/",
        "title": "IDEMC - Volcano activity report in the US",
        "status": 600,
        "message": "Wrong, missing or expired api key",
        "api": "1.0.4",
        "count": 0
    }
}  

Resource Information

Rate Limited True
Response Format GeoJSON
Authentication Yes