v5

latestOpenAPI 3.1.0Proprietary2026-08-031,5423,1505.5 MB

Disasters & Hazards

Active tsunami messages (NOAA/NWS Tsunami Warning Centers)

Currently-active tsunami CAP 1.2 messages retransmitted from the NOAA/NWS Tsunami Warning Centers (NTWC Palmer AK + PTWC Honolulu HI). CAP-native: severity/certainty/urgency are read verbatim from the source (severity.derivation='native'), and the full CAP block is exposed. Gated to status=Actual, non-Cancel, non-expired messages; an empty result means no active message is published. Sugra retransmits and does not issue warnings.

get/api/v2/hazards/tsunami

Query parameters

min_latnumber nullable

Bounding-box south edge (on the source epicenter).

max_latnumber nullable

Bounding-box north edge.

min_lonnumber nullable

Bounding-box west edge.

max_lonnumber nullable

Bounding-box east edge.

limitinteger

Maximum messages returned (most recently updated first).

Response

Successful Response

Example response

{
  "data": {
    "query": {
      "limit": 50
    },
    "events": [
      {
        "schema_version": "hazard-event/2",
        "event_id": "ntwc-the5je",
        "event_type": "tsunami",
        "geometry": {
          "lat": 34.1,
          "lon": -118.2,
          "depth_km": 8
        },
        "metrics": {
          "preliminary_magnitude": "8.3",
          "magnitude_type": "MWP",
          "depth_km": 10,
          "epicenter": "Near Coast of Central Chile",
          "msg_type": "Alert",
          "cap_event": "Tsunami Warning"
        },
        "severity": {
          "severity": "Moderate",
          "certainty": "Observed",
          "urgency": "Past",
          "derivation": "sugra-computed"
        },
        "source": {
          "institution": "USGS",
          "tier": "S"
        }
      }
    ],
    "attribution": {
      "sources": [
        {
          "registry_key": "usgs/earthquake",
          "source_name": "USGS Earthquake",
          "licence": "public-domain",
          "citation": "U.S. Geological Survey Earthquake Hazards Program",
          "disclaimer": "Magnitudes are preliminary and subject to revision."
        }
      ],
      "effective_reexport": "allowed"
    }
  },
  "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",
    "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"
    ]
  }
}