{
  "status": "ok",
  "name": "Hail History API",
  "version": "1.0.0",
  "description": "Radar-detected hail history for any US address or coordinate, from NOAA NCEI SWDI nx3hail (NEXRAD Level-III Hail Detection Algorithm). Keyless, no registration, CORS open.",
  "endpoints": {
    "/hail-history": {
      "method": "GET",
      "params": {
        "address": "US one-line address (mutually exclusive with lat/lon)",
        "lat": "decimal degrees, -90..90",
        "lon": "decimal degrees, -180..180",
        "from": "start calendar year (default: to - 19)",
        "to": "end calendar year (default: current year)",
        "detail": "\"none\" (default) | \"top\" | a specific day as YYYY-MM-DD",
        "topN": "1..5, only with detail=top (default 3)"
      },
      "examples": [
        "/hail-history?lat=35.4676&lon=-97.5164",
        "/hail-history?address=100 N Broadway Ave, Oklahoma City OK&from=2020&to=2025",
        "/hail-history?lat=35.4676&lon=-97.5164&detail=2024-06-26"
      ]
    },
    "/health": {
      "method": "GET",
      "description": "this document"
    }
  },
  "resolution": {
    "unit": "0.1-degree grid tile",
    "note": "Answers describe a tile roughly 6.9 miles north-to-south (east-west narrows with latitude), NOT an individual rooftop."
  },
  "upstream": {
    "hail": "https://www.ncei.noaa.gov/swdiws/csv/nx3hail/",
    "hailDocs": "https://www.ncdc.noaa.gov/swdiws/",
    "periodOfRecord": {
      "begin": "1992-05-07",
      "endObserved": "2026-07-25"
    },
    "geocoder": "https://geocoding.geo.census.gov/geocoder/"
  },
  "auth": "none",
  "cors": "*",
  "retrievedAt": "2026-07-28T12:58:45.250Z"
}