Japan Meteorological Agency Earthquake Information & Tsunami Forecast JSON API

Earthquake Information List

get

https://api.p2pquake.net/v2https://api-v2-sandbox.p2pquake.net/v2wss://api-realtime-sandbox.p2pquake.net/v2

/jma/quake

Returns earthquake information. Default is newest first, maximum 10 items. Data is provided from January 10, 2015.

• Approximately 60 seconds delay compared to other APIs (/history or /ws). Not suitable for latest information retrieval.

• Intended for historical data display and search purposes.

Query parameters

limitinteger · int32 · min: 1 · max: 100Optional

Number of items to return (1-100, default is 10)

offsetinteger · int32Optional

Number of items to skip (0 or greater, default is 0). For example, limit=100&offset=200 returns 100 items starting from the 201st item.

orderinteger · enumOptional

Sort order. 1 is ascending (oldest first), -1 is descending (newest first). Default is descending.

Possible values:

since_datestringOptional

On or after specified date (yyyyMMdd format)

Pattern: \d{8}

until_datestringOptional

On or before specified date (yyyyMMdd format)

Pattern: \d{8}

quake_typestring · enumOptional

Type of earthquake information. Values are ScalePrompt(Seismic Intensity Prompt Report), Destination(Hypocenter Information), ScaleAndDestination(Seismic Intensity and Hypocenter Information), DetailScale(Regional Seismic Intensity Information), Foreign(Distant Earthquake Information), Other(Other Information).

Possible values:

min_magnitudenumberOptional

Minimum magnitude

max_magnitudenumberOptional

Maximum magnitude

min_scaleinteger · enumOptional

Lower limit of maximum seismic intensity. Values are 10(Intensity 1), 20(Intensity 2), 30(Intensity 3), 40(Intensity 4), 45(Intensity 5-), 50(Intensity 5+), 55(Intensity 6-), 60(Intensity 6+), 70(Intensity 7).

Possible values:

max_scaleinteger · enumOptional

Upper limit of maximum seismic intensity. Values are 10(Intensity 1), 20(Intensity 2), 30(Intensity 3), 40(Intensity 4), 45(Intensity 5-), 50(Intensity 5+), 55(Intensity 6-), 60(Intensity 6+), 70(Intensity 7).

Possible values:

prefectures[]object[]Optional

Minimum seismic intensity for each prefecture. Specify like "Hyogo Prefecture,10".

Responses

200

Earthquake Information List

application/json

Earthquake Information

idstringRequired

Unique ID to identify the information

codeanyRequired

Information code. Always 551.

timestringRequired

Reception date and time. Format is 2006/01/02 15:04:05.999.

400

Parameter error

get

/jma/quake

HTTPcURLJavaScriptPython

GET /v2/jma/quake HTTP/1.1
Host: api.p2pquake.net
Accept: */*

[
  {
    "id": "5ee1681202add671a1e1ae39",
    "time": "2019/08/26 21:04:06.958",
    "code": 551,
    "issue": {
      "source": "Japan Meteorological Agency",
      "time": "2019/08/26 20:57:00",
      "correct": "None",
      "type": "DetailScale"
    },
    "earthquake": {
      "domesticTsunami": "None",
      "foreignTsunami": "Unknown",
      "hypocenter": {
        "depth": 50,
        "latitude": 24.4,
        "longitude": 125.2,
        "magnitude": 4,
        "name": "Near Miyakojima Island"
      },
      "maxScale": 10,
      "time": "2019/08/26 20:53:00"
    },
    "points": [
      {
        "addr": "Miyakojima City Gusukube Fukuhoku",
        "isArea": false,
        "pref": "Okinawa Prefecture",
        "scale": 10
      },
      {
        "addr": "Miyakojima City Irabu Nagahama",
        "isArea": false,
        "pref": "Okinawa Prefecture",
        "scale": 10
      }
    ],
    "comments": {
      "freeFormComment": ""
    }
  }
]

Earthquake Information

get

https://api.p2pquake.net/v2https://api-v2-sandbox.p2pquake.net/v2wss://api-realtime-sandbox.p2pquake.net/v2

/jma/quake/{id}

Path parameters

idstringRequired

ID

Responses

200

Returns earthquake information for the specified ID.

application/json

Earthquake Information

idstringRequired

Unique ID to identify the information

codeanyRequired

Information code. Always 551.

timestringRequired

Reception date and time. Format is 2006/01/02 15:04:05.999.

400

Invalid ID format

404

Information with specified ID not found

get

/jma/quake/{id}

HTTPcURLJavaScriptPython

GET /v2/jma/quake/{id} HTTP/1.1
Host: api.p2pquake.net
Accept: */*

{
  "id": "5ee1681202add671a1e1ae39",
  "time": "2019/08/26 21:04:06.958",
  "code": 551,
  "issue": {
    "source": "Japan Meteorological Agency",
    "time": "2019/08/26 20:57:00",
    "correct": "None",
    "type": "DetailScale"
  },
  "earthquake": {
    "domesticTsunami": "None",
    "foreignTsunami": "Unknown",
    "hypocenter": {
      "depth": 50,
      "latitude": 24.4,
      "longitude": 125.2,
      "magnitude": 4,
      "name": "Near Miyakojima Island"
    },
    "maxScale": 10,
    "time": "2019/08/26 20:53:00"
  },
  "points": [
    {
      "addr": "Miyakojima City Gusukube Fukuhoku",
      "isArea": false,
      "pref": "Okinawa Prefecture",
      "scale": 10
    },
    {
      "addr": "Miyakojima City Irabu Nagahama",
      "isArea": false,
      "pref": "Okinawa Prefecture",
      "scale": 10
    }
  ],
  "comments": {
    "freeFormComment": ""
  }
}

Tsunami Forecast List

get

https://api.p2pquake.net/v2https://api-v2-sandbox.p2pquake.net/v2wss://api-realtime-sandbox.p2pquake.net/v2

/jma/tsunami

Returns tsunami forecasts. Default is newest first, maximum 10 items. Data is provided from November 22, 2016.

• Approximately 60 seconds delay compared to other APIs (/history or /ws). Not suitable for latest information retrieval.

• Intended for historical data display and search purposes.

Query parameters

limitinteger · int32 · min: 1 · max: 100Optional

Number of items to return (1-100, default is 10)

offsetinteger · int32Optional

Number of items to skip (0 or greater, default is 0). For example, limit=100&offset=200 returns 100 items starting from the 201st item.

orderinteger · enumOptional

Sort order. 1 is ascending (oldest first), -1 is descending (newest first). Default is descending.

Possible values:

since_datestringOptional

On or after specified date (yyyyMMdd format)

Pattern: \d{8}

until_datestringOptional

On or before specified date (yyyyMMdd format)

Pattern: \d{8}

Responses

200

Tsunami Forecast List

application/json

Tsunami Forecast

idstringRequired

Unique ID to identify the information

codeanyRequired

Information code. Always 552.

timestringRequired

Reception date and time. Format is 2006/01/02 15:04:05.999.

cancelledbooleanRequired

Whether the tsunami forecast has been cancelled. When true, areas is an empty array.

400

Parameter error

get

/jma/tsunami

HTTPcURLJavaScriptPython

GET /v2/jma/tsunami HTTP/1.1
Host: api.p2pquake.net
Accept: */*

[
  {
    "id": "5ee1ad7e02add676dd5a67a0",
    "time": "2020/06/11 13:05:18.249",
    "code": 552,
    "cancelled": false,
    "issue": {
      "source": "Japan Meteorological Agency",
      "time": "2019/06/18 22:24:00",
      "type": "Focus"
    },
    "areas": [
      {
        "grade": "Warning",
        "immediate": true,
        "name": "Fukushima Prefecture",
        "firstHeight": {
          "condition": "Tsunami arrival in progress (estimated)"
        },
        "maxHeight": {
          "description": "3m",
          "value": 3
        }
      },
      {
        "grade": "Watch",
        "immediate": false,
        "name": "Aomori Prefecture Pacific Coast",
        "firstHeight": {
          "arrivalTime": "2019/06/18 22:40:00"
        },
        "maxHeight": {
          "description": "1m",
          "value": 1
        }
      }
    ]
  }
]

Tsunami Forecast

get

https://api.p2pquake.net/v2https://api-v2-sandbox.p2pquake.net/v2wss://api-realtime-sandbox.p2pquake.net/v2

/jma/tsunami/{id}

Path parameters

idstringRequired

ID

Responses

200

Returns tsunami forecast for the specified ID.

application/json

Tsunami Forecast

idstringRequired

Unique ID to identify the information

codeanyRequired

Information code. Always 552.

timestringRequired

Reception date and time. Format is 2006/01/02 15:04:05.999.

cancelledbooleanRequired

Whether the tsunami forecast has been cancelled. When true, areas is an empty array.

400

Invalid ID format

404

Information with specified ID not found

get

/jma/tsunami/{id}

HTTPcURLJavaScriptPython

GET /v2/jma/tsunami/{id} HTTP/1.1
Host: api.p2pquake.net
Accept: */*

{
  "id": "5ee1ad7e02add676dd5a67a0",
  "time": "2020/06/11 13:05:18.249",
  "code": 552,
  "cancelled": false,
  "issue": {
    "source": "Japan Meteorological Agency",
    "time": "2019/06/18 22:24:00",
    "type": "Focus"
  },
  "areas": [
    {
      "grade": "Warning",
      "immediate": true,
      "name": "Fukushima Prefecture",
      "firstHeight": {
        "condition": "Tsunami arrival in progress (estimated)"
      },
      "maxHeight": {
        "description": "3m",
        "value": 3
      }
    },
    {
      "grade": "Watch",
      "immediate": false,
      "name": "Aomori Prefecture Pacific Coast",
      "firstHeight": {
        "arrivalTime": "2019/06/18 22:40:00"
      },
      "maxHeight": {
        "description": "1m",
        "value": 1
      }
    }
  ]
}