{"uid":"cap_xsO-O10SwyW7ClslDaDbW","slug":"x402-hail-history-920a0261","name":"x402 Hail History","description":"Every day with hail at a US address or lat/lon over up to 5 years (from 2020-10-14): the dates when NOAA's radar estimate of hail size (MRMS MESH) reached 0.75 inch or a size you choose within 1, 3, 5 or 10 miles, with the largest size each day. For property due diligence, roof age questions and claim history. Not found addresses are not charged.","url":"https://hail.kagurazaka.dev/v1/hail/history?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","properties":{"to":{"type":"string","description":"last day, YYYY-MM-DD; default the latest day available"},"lat":{"type":"number","description":"latitude, instead of address"},"lon":{"type":"number","description":"longitude, instead of address"},"from":{"type":"string","description":"first day, YYYY-MM-DD; default 5 years before to"},"address":{"type":"string","description":"a US street address on one line, such as 200 W 2nd St, Wichita, KS 67202"},"radius_mi":{"enum":[1,3,5,10],"type":"integer","description":"radius in miles, default 3"},"min_size_in":{"type":"number","description":"smallest hail size to count, inches, 0.75 (default) to 4"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"to":{},"days":{},"from":{},"count":{},"notes":{},"largest":{},"location":{},"radius_mi":{},"min_size_in":{}}}}}}},"responseSchema":{"type":"json","example":{"to":"2025-05-16","days":[{"date":"2025-05-16","max_size_in":2.19,"at_location_in":1.08}],"from":"2025-05-16","count":1,"notes":["..."],"largest":{"date":"2025-05-16","max_size_in":2.19},"location":{"lat":37.1,"lon":-88.96,"input":"37.1,-88.96","matched":"37.1, -88.96","geocoder":"none"},"radius_mi":3,"min_size_in":0.75}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.5","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.5/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.5","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.5","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_PAC0EC3TqYCMC8sQXRAIE","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.5","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns every day with hail at a US address or lat/lon over up to 5 years, including largest hail size per day from NOAA MRMS MESH radar data.","exampleAgentPrompt":"Can you pull the full hail history for 200 W 2nd St, Wichita, KS 67202 over the last 5 years, looking within 3 miles for hail of at least 0.75 inches, so I can check if the roof has been hit?","exampleUseCases":[{"title":"Pre-purchase property hail due diligence","prompt":"I'm buying a house at 412 Elm Street, Norman, OK 73069 — can you check if it's had any hail hits of 1 inch or bigger within 3 miles over the past 5 years? I want to know how many times and the biggest size each day."},{"title":"Insurance claim hail verification","prompt":"My client is filing a claim for roof damage at 5501 N Broadway Ave, Oklahoma City, OK 73112. Can you pull the hail history within 1 mile of that address from 2022-01-01 to 2023-12-31 and tell me the largest hail size recorded on each day?"},{"title":"Roofing contractor age-of-roof estimate","prompt":"We're quoting a roof replacement for a property at 37.1 latitude, -88.96 longitude — can you show me every hail event within 5 miles since 2020 with hail at least 0.75 inches so we can estimate the roof wear?"}],"resultDescription":"A JSON object listing every day with hail at the queried location within the specified radius and size threshold, including the date, maximum nearby hail size, at-location hail size, a summary of the largest event, total count of hail days, the matched location coordinates, and any relevant notes about data coverage or geocoding.","failureModes":["Address not found or cannot be geocoded — request is not charged, returns a not-found result","Invalid date range (e.g. before 2020-10-14 or future dates beyond available data)","Invalid radius value (must be 1, 3, 5, or 10 miles)","Minimum hail size out of range (must be 0.75 to 4 inches)","No hail events found for the location/period — returns count:0 with empty days array","Payment not completed via x402 protocol — request blocked"],"whenToPreferThis":"Choose this endpoint when you need a multi-year chronological log of all hail events at a specific US property or coordinate — ideal for insurance claim verification, roof age assessment, property due diligence, or any workflow requiring date-stamped hail size history. Prefer this over point-in-time hail lookups when you need the full historical picture across multiple events rather than a single date.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-02T12:30:51.186Z","isFirstParty":false,"canonicalSlug":"x402-hail-history-920a0261"}