Hazard alerts (GDACS, tsunami, NAVAREA, USGS)

CEV-OS / Data API / Hazard alerts (GDACS, tsunami, NAVAREA, USGS)

CEV-OS Data API · last updated 2026-11-04. Status: live. Version 1.

Use this when you need current natural-hazard alerts coarsened to country or NAVAREA region: GDACS, NOAA tsunami, NGA maritime warnings and USGS earthquakes.

What it is

Active hazard alerts from GDACS (EC-JRC / UN OCHA; attribution required, not for life-safety use), NOAA tsunami messages (NTWC/PTWC), NGA maritime warnings reduced to NAVAREA region (not for navigation), and USGS M2.5+ earthquakes (credit requested) reduced to country. Filter by country or region. If an upstream feed is down the others are still returned with degraded=true and missing[] (each missing input includes last-good as_of when known). 503 only when every input is empty. No coordinates or station IDs.

Endpoints

REST: GET /v1/hazard-alerts on https://api.cev-os.com
Legacy host (same service): GET /v1/hazard-alerts on https://cev-os.com
MCP tool: get_hazard_alerts on https://mcp.cev-os.com/mcp

Parameters

Query parameters for `GET /v1/hazard-alerts`
Name	Type	Description	Constraints
`country`	string	ISO 3166-1 alpha-2 country filter.	example JP; pattern ^[A-Za-z]{2}$
`region`	string	Case-insensitive substring on NAVAREA / tsunami center / country name, e.g. NAVAREA IV.	example NAVAREA IV

Example request

No account and no key. Query values below are the examples or defaults from the registry. An optional free key (header x-api-key) raises the limits; create one at https://cev-os.com/#api_keys after signing in with a verified email (Google sign-in is already verified).

curl -s "https://api.cev-os.com/v1/hazard-alerts?country=JP&region=NAVAREA%20IV"

Example response

Every /v1 response is a JSON envelope (schema_version, product, timestamps, license, attribution, data). The registry example is the data member:

{
  "count": 2,
  "degraded": false,
  "missing": [],
  "alerts": [
    {
      "source": "gdacs",
      "title": "Red earthquake alert",
      "hazard": "Earthquake",
      "alert_level": "Red",
      "severity": 5,
      "country": "Japan",
      "url": "https://www.gdacs.org/"
    },
    {
      "source": "nga",
      "title": "NAVAREA IV 123/26",
      "region": "NAVAREA IV",
      "severity": 3,
      "url": "https://msi.nga.mil/NavWarnings"
    }
  ]
}

Update frequency

TRIPWIRE: GDACS 15 min, tsunami 5 min, NGA 60 min, USGS 5 min; Data API caches 3 min.

Public cache: 180 seconds (Cache-Control: public, max-age=180).

Sources, license and usage

License status: cleared with attribution. GDACS requires attribution and is not for life-safety use. NOAA tsunami and NGA warnings are US Government work (not for navigation). USGS credit requested.

Underlying sources
Source	License	commercialOk	Terms
GDACS (EC-JRC / UN OCHA)	Attribution required; not for life-safety use (EC-JRC content CC BY 4.0)	true	—
NOAA / NWS Tsunami Warning Centers	US Government work (public domain)	true	—
NGA Maritime Safety Information (NAVAREA warnings)	US Government work (public domain). Not for navigation.	true	—
U.S. Geological Survey earthquakes	US Government work (public domain); credit requested	true	—

Attribution (show this wherever you display the data):

GDACS, Global Disaster Alert and Coordination System, EC-JRC / UN OCHA (https://www.gdacs.org/). GDACS alerts are automatic estimates. Not for life-safety use; follow official national authorities.
NOAA / NWS Tsunami Warning Centers (https://www.tsunami.gov/).
NGA Maritime Safety Information (https://msi.nga.mil/). Not for navigation.
U.S. Geological Survey (https://earthquake.usgs.gov/); credit requested.

Privacy class: public-derived. Access: public. Price: free (price is null; pay-per-call is not active).

Gaps

Location is country or NAVAREA region only; no coordinates.
Partial responses (degraded=true) omit down feeds such as NGA MSI; 503 only if gdacs, tsunami, nga_warnings and usgs are all empty.

Disclaimer

Not an official warning. GDACS is not for life-safety use. NGA maritime warnings are not for navigation.

Data API hub (all products, limits, license notes)
MCP Registry listing com.cev-os/data
OpenAPI 3.1
Machine product list: /v1/products
CEV-OS TRIPWIRE incidents (explainer)

Reference data, not investment advice.