Hazard History
hazard_historyNatural-hazard history for a US county or address: FEMA declarations (major disasters, emergencies and fire management, by type, with links), NOAA storm events with deaths and reported property damage by type and year, and USGS earthquakes within 100 km since 1950. One call, each source reported apart.
Three federal sources, fetched together:
FEMA declarations for the county since 1 January of the first year: the total (major disasters, emergencies and fire management), major disasters alone, count by incident type, and the declarations themselves with FEMA ids and links. Statewide declarations are included.
NOAA Storm Events for the county: events, deaths, injuries and reported property and crop damage (nominal dollars; unreported damage counts as 0, so it is a floor), by type and by year, plus the worst events. Events NOAA records for a forecast zone covering only this county (most heat and winter-storm deaths) count as the county's own; a zone covering several counties is counted, but its casualties and damage are reported apart in
zone_based, because they are shared. The current year is incomplete; NOAA can trail by months.USGS earthquakes of magnitude 2.5 or more within 100 km of the point since 1950: the count and the five largest. This needs a point, so it is skipped when only a county GEOID is given.
Each section has its own status; if one source is down the others still answer. If neither FEMA nor NOAA can answer, the call fails and is not charged. Connecticut's planning regions (since 2022) are not yet matched to the old counties FEMA and NOAA still use, so they are not answered; the old county GEOIDs (09001-09015) work. A GEOID that is not a county is not found. A geoid is used only when no address or coordinate is given.
When to use: Use for "has this area had floods, hurricanes or earthquakes", disaster declarations, storm damage history, or natural-hazard due diligence for a US property or county. For the flood zone at a property use flood_zone; for everything about an address in one call use address_profile.
Billed as property.hazard_history at 2c.
Every response includes a sources[] array naming the data origin and licence.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| lat | No | ||
| lon | No | ||
| geoid | No | Five-digit county GEOID, instead of a place (no earthquake section then). | |
| years | No | Full years back from 1 January, plus the current year so far. | |
| address | No | A US street address. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| point | No | ||
| years | Yes | ||
| county | Yes | ||
| storms | Yes | ||
| summary | Yes | ||
| disasters | Yes | ||
| earthquakes | Yes |