Search NOAA Storm Events
noaa_climate_search_storm_eventsSearch the NCEI Storm Events Database for one calendar year — tornadoes, hail, floods, hurricanes, winter storms, heat, and every other NWS Storm Data event type, with magnitude, direct and indirect deaths and injuries, property and crop damage, and the episode and event narratives. This is a different NOAA corpus from the CDO tools on this server: it carries discrete severe-weather events rather than station observations, needs no token, and is published as one bulk file per year, so year is required. Filter with state (the full upper-case name NCEI writes, e.g. "FLORIDA" — not the postal code "FL"), eventType (the exact NWS label, e.g. "Tornado", "Hail", "Flash Flood", "Hurricane (Typhoon)", matched case-insensitively), month, and minDamageInUsd. Damage arrives from NCEI as a magnitude-suffixed string ("75.00K", "1.20M", "1.00B") and is returned as both the raw cell and a parsed dollar amount; an unreported figure is omitted entirely rather than reported as zero, and minDamageInUsd therefore excludes those rows and says how many it dropped. Results come back in the source file's own row order, paged with limit and offset, and totalCount is the true match count for the whole year.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| year | Yes | Calendar year to search (1950 through the current partial year). Required — NCEI publishes one file per year, so an unscoped search would download every year back to 1950. | |
| limit | No | Maximum number of events to return (1–100). Defaults to 50. | |
| month | No | Filter to events whose begin date falls in this month (1–12). Optional. | |
| state | No | Filter to this state or territory, written as the full name NCEI uses (e.g. "FLORIDA", "PUERTO RICO"), matched case-insensitively. Postal codes like "FL" match nothing. Optional. | |
| offset | No | Zero-based index of the first matching event to return. Defaults to 0. | |
| eventType | No | Filter to this NWS event type, matched case-insensitively against the exact label (e.g. "Tornado", "Hail", "Flash Flood", "Hurricane (Typhoon)"). A miss returns the labels present in that year. Optional. | |
| minDamageInUsd | No | Filter to events whose property damage parses to at least this many dollars. Excludes every row whose damage NCEI did not report — about a fifth of a recent year — since an unreported figure cannot be shown to clear the threshold. Optional. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cap | No | The limit that was applied. Omitted otherwise. | |
| year | No | The calendar year searched. | |
| error | No | Present when the call failed. Absent on success. | |
| shown | No | Events returned on this page. Omitted otherwise. | |
| events | No | Matching events for the requested page, in the source file’s own row order. | |
| notice | No | Guidance when nothing matched or the page ran past the end. Omitted otherwise. | |
| exhausted | No | True when offset is past the end of a non-empty match set — the page is empty but matches exist. Omitted otherwise. | |
| truncated | No | True when more matches exist beyond this page. Omitted otherwise. | |
| sourceFile | No | The exact NCEI file this page was read from, including its `_c<publishDate>` suffix — the suffix changes whenever NCEI republishes a year. | |
| totalCount | No | Events matching every filter across the whole year, before offset and limit. | |
| scannedRowCount | No | Rows read from the source file, matched or not. Omitted when unavailable. | |
| excludedUnknownDamage | No | Rows that satisfied every other filter but were dropped by minDamageInUsd because NCEI reported no property-damage figure for them. Omitted when minDamageInUsd was not supplied. |