This API service summarizes the tsunami reporting of three major Tsunami Warning Centers. The original master data is supplemented, analyzed and published by IDEMC in a standardized, standard GeoJSON format.

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

Resource URL

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

Parameters

ParameterDescriptionOptionalDefault
api_key Authentication API key Required None

Example

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

Request

  {
    "api_key" : "xycvbnm234ztr"
}  

Response

  {
    "type": "FeatureCollection",
    "metadata": {
        "generated": "Thu, 13 Aug 2020 06:55:55 +0000",
        "url": "https://api.idemc.org/tsunami/v1/",
        "title": "IDEMC - Tsunami report",
        "status": 200,
        "message": "Data has been published",
        "api": "1.0.4",
        "count": 10
    },
    "features": [
    {
        "id": "296",
        "type": "Feature",
        "geometry": {
            "type": "Point",
            "coordinates": [
                "-158.016",
                "55.121"
            ]
        },
        "properties": {
            "main_category": "Geological Event",
            "sub_category": "tsunami",
            "main_category_code": "GE",
            "sub_category_code": "TSU",
            "issue_time": "2020-08-09T15:02:28+00:00",
            "expire_time": "2020-08-09T16:02:28+00:00",
            "category": "Tsunami Information",
            "location": {
                "area_code": "05",
                "area_name": "North America",
                "country_code": "5010",
                "country_name": "United states",
                "surface_name": "Gulf of Alaska",
                "region_name": "North Pacific",
                "location": "113 kms SE of the Perryville, Alaska, USA, North-America"
            },
            "magnitude": 5.4,
            "depth": 32,
            "instruction": "There is NO tsunami danger from this earthquake.  This will be the only U.S. National Tsunami Warning Center    message issued for this event unless additional information    becomes available.   The location and magnitude are based on preliminary information.   Further information will be issued by the United States    Geological Survey (earthquake.usgs.gov) or the appropriate    regional seismic network.",
            "description": "This is a Tsunami Information Statement.  - Event details: Preliminary magnitude 5.4 (Ml) earthquake / Lat: 55.121, Lon: -158.016 at 2020-08-09T14:57:54 UTC An information statement indicates that an earthquake has occurred, but does not pose a tsunami threat, or that a tsunami warning, advisory, or watch has been issued for another section of the ocean.",
            "provider": "Pacific Tsunami Warning Center",
            "data_confidence": 1
        }
    }
}  

Error Response

  {
    "type": "FeatureCollection",
    "metadata": {
        "generated": "Mon, 25 Nov 2019 16:15:54 +0000",
        "url": "https://api.idemc.org/tsunami/v1/",
        "title": "IDEMC - Tsunami report",
        "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