Skip building the hail pipeline
The Hail Reports by Address API gives developers property-level hail information without requiring their teams to build and maintain the underlying hail-processing system.
Your application submits an address. HailGeeks resolves the property location, checks the available hail history, and returns the report information included with your developer access.
Results may be returned as structured data. Approved integrations may also request generated PDF reports.
Common uses
One property, not a whole ZIP
City, county, and ZIP-level hail information can show that hail occurred somewhere across a broader area. It does not explain what was estimated at one particular property. Each question below maps to a field your application can read.
Field names are illustrative. The API provides estimated property-level weather analysis — it does not confirm that hail struck or damaged the property.
Three report products
Test all three with deterministic sandbox fixtures. Production keys receive the scopes approved for the integration.
Property Hail History
Two-year qualifying history with per-date detail.
Event Detail
Essential evidence for one selected event.
Full Event
Event Detail, plus deep metrics.
Production availability is controlled by the scopes approved for the integration.
Inspection-related signals are not included as a standard API field. Any access to a named inspection-related signal requires separate approval and applicable display requirements.
Sample payloads shown on this page are illustrative. The API returns estimated property-level weather analysis — not confirmed hail impact or damage.
Address in, report out
Submit an address
Your application sends a property address through an authenticated API request.
Resolve the property location
HailGeeks resolves the address to the coordinates used for the analysis, and may indicate whether it resolved to a rooftop or an estimated location.
Validate the geographic information
A caller-supplied ZIP or other geography is not treated as authoritative. HailGeeks independently derives or validates the ZIP against the resolved location.
Check the available hail history
The system checks up to two years of available history for qualifying hail activity associated with the property.
Select an event
Choose an available hail date from Property Hail History, then submit that address and date for Event Detail or Full Event.
Receive the results
The API returns the property and event information included with your developer access.
Use the results in your product
Present the approved information inside your own interface, property record, customer workflow, internal system, or permitted report.
Where the data fits in a product
Property Hail History
Add recent hail history to a property profile, inspection record, customer account, or property-management workflow.
Users can review qualifying hail days and the event details connected to the address.
Roofing and Inspection Intake
Check recent hail history when a property enters a roofing, inspection, or home-service workflow.
An initial property-level weather signal before a professional decides whether closer review is appropriate.
Post-Storm Follow-Up
Use recent property-level hail results to help organize follow-up after a storm.
Work from an address-specific result instead of a broad city or ZIP-level signal.
Customer Hail Reports
Present approved hail information within a customer portal, application, or property report.
Depending on the report product, explain when hail was estimated, how large it was, how long it lasted, and what occurred nearby.
Real Estate Property Review
Add recent hail history to workflows for buyers, sellers, inspectors, and agents.
Surface roof or exterior questions that may deserve closer review before a transaction moves forward.
Internal Property Review
Bring hail information into internal dashboards, customer-service tools, property records, or operations.
Teams review recent hail activity without leaving for a separate hail-report platform.
Property applications
Available for approved integrations across roofing, property technology, inspection, insurance, real estate, and home-service applications.
Developer requests are reviewed based on the intended use, expected request volume, required report information, and how the results will be presented.
Two separate forms of evidence
Property-level hail metrics are derived from radar-based analysis. NWS hail and wind reports provide additional ground-reported context, and they do not modify the radar estimates.
The absence of a nearby NWS report does not prove that hail or strong wind did not occur at the property.
NWS fields, by report product
What the API does not say
A Hail Report by Address provides estimated hail exposure and detailed storm context. It cannot confirm that an individual hailstone struck a roof or that physical damage occurred.
API results should not be presented as proof of roof damage, insurance coverage, claim eligibility, causation, or repair scope. When the information suggests closer review may be appropriate, the next step may be a safe ground-level assessment or professional inspection.
Sandbox now, production when ready
Create an eligible HailGeeks account to activate the deterministic sandbox immediately. The console issues one default sandbox key and fixture calls use no credits.
When the integration is ready for live data, submit a production application. Approval defines the production scopes and request-rate limit; live reports use wallet credits.
Access may vary based on
Hail Reports by Address API FAQ
Request Live API access
The sandbox is instant and does not require this form. Use this application for production access with live data and wallet credits.