---
title: "List hurricane catastrophe events (FEMA declarations + NOAA metadata)"
method: GET
path: "/v1/cat/events"
---

# List hurricane catastrophe events (FEMA declarations + NOAA metadata)

`GET /v1/cat/events`

## Request

- Base URL: `https://api.querylines.com`
- URL: `https://api.querylines.com/v1/cat/events`
- Auth: none declared

Free. Each event groups the per-state FEMA disaster declarations for one named storm and adds NOAA HURDAT2 landfall metadata (Saffir-Simpson category, date, wind, min pressure -- null for the latest season until HURDAT2 updates). `state` filters to events that declared at least one county in that state/territory. Per-county declaration detail and the county-premium exposure join are paid (/v1/cat/counties, /v1/cat/exposure).

## Query parameters

- `peril` string
- `year` integer
- `state` string
- `limit` integer

## Response `200`

Events, most recent storm year first.

- object
  - `peril` string, nullable, required
  - `year` number, nullable, required
  - `state` string, nullable, required
  - `count` number, required
  - `events` object[], required
    - `event_key` string, required: Stable slug, e.g. hurricane-ian-2022.
    - `name` string, required
    - `peril` string, required
    - `year` number, required: Storm calendar year (not FEMA fiscal year).
    - `noaa_storm_id` string, nullable, required: HURDAT2 id, e.g. AL092022; null if unlinked.
    - `max_category` number, nullable, required: Saffir-Simpson 1-5 at strongest landfall; null if unenriched.
    - `landfall_date` string, nullable, required
    - `landfall_wind_mph` number, nullable, required
    - `min_pressure_mb` number, nullable, required
    - `states` string[], required: Affected state/territory codes.
    - `declared_county_count` number, required
  - `report_date` string, nullable, required
  - `data_as_of` string, nullable, required
  - `source` string, nullable, required
  - `coverage_note` string, required

## Other responses

- `400`: Invalid query parameters.
- `500`: Internal error.

---

[API](https://skmtc.dev/querylines/apis/querylines-api.md) · [All operations](https://skmtc.dev/querylines/apis/querylines-api/llms.txt) · [OpenAPI document](https://skmtc.dev/querylines/apis/querylines-api/revisions/4afb6c3e2b1f?raw)