What Hit My House

Hail History API

Radar-detected hail history for any US address. Free, keyless, CORS open.

Returns every day NOAA's NEXRAD Level-III Hail Detection Algorithm registered hail over the grid tile containing an address, with per-year counts. No API key, no registration, no signup.

Read this before you build on it. Answers describe a 0.1° grid tile — roughly 7 miles north-to-south — not a rooftop. A detection inside the tile does not prove hail fell on a specific structure, and no detection does not prove none fell. Radar resolution is finest near the radar and coarsens with distance. This is a screening tool, not an insurance claim, a loss report, or an engineering inspection.

Endpoint

GET https://whathitmyhouse.com/.netlify/functions/hail-history

Give it either an address or a lat/lon pair.

ParameterNotes
addressUS one-line address. Mutually exclusive with lat/lon. Needs a house number and street — a city name alone will not geocode.
lat / lonDecimal degrees. Use these to skip geocoding entirely.
fromStart calendar year, inclusive. Clamped to the period of record.
toEnd calendar year, inclusive. Clamped to the current year.
detailnone (default), top for the busiest days, or a specific date.
topNHow many busiest days to expand when detail=top.

Example

curl "https://whathitmyhouse.com/.netlify/functions/hail-history?lat=35.4676&lon=-97.5164&from=2015&to=2020"

Returns, for that tile near Oklahoma City:

"result": {
  "coverage": "detections_found",
  "yearsCovered": 6,
  "fromYear": 2015,
  "toYear": 2020,
  "hailDays": 40,
  "totalRadarDetections": 151,
  "yearsWithHail": 6
}

A location with no hail returns coverage: "no_detections" — a real answer, not an error.

What every response carries

searchAreaThe exact tile bounds searched, so you can see what "near this address" meant.
fetchStrategyHow many upstream NOAA requests were used, and why.
sourceDataset attribution and the upstream service URL.
retrievedAtWhen the data was pulled. Nothing is cached behind your back.
disclaimerThe tile-not-rooftop caveat, in the payload rather than buried in docs.

Source and limits

Hail data comes live from the NOAA NCEI Severe Weather Data Inventory, dataset nx3hail. Geocoding uses the US Census geocoder. Both are US government open data and neither requires a key.

No rate limit is documented by the upstream source, which is not the same as there being none — be reasonable. Machine-readable spec: openapi.json.

← Hail history lookup · Flood zone, earthquake hazard, climate and growing season for the same address

What Hit My House · Fredericksburg, Virginia · hello@whathitmyhouse.com
Independent. Not affiliated with, endorsed by, or sponsored by NOAA, the National Weather Service, or any government agency. Built on public-domain federal data. How this works and how we make money.