ATTENTION! Damaging hail detected. Hail tracking is now active for these regions: Provo, UT • Logan, UT • Ogden, UT • Salt Lake City, UT      
HailGeeks
Sign In Join as a Pro
For Developers

Hail Reports by Address API

Add property-level hail reports to your application

Send an address. Get back structured hail history and event detail for that property — no radar pipeline to build, no grids to maintain.

hail-report.request
POST /v1/reports/event-detail
{
"address": "4312 Oak Ridge Dr, Minneapolis, MN",
"event_date": "2026-05-18",
"request_uuid": "3186d2cc-6b9c-4cad-afed-60241cd5bfca"
}
200 OK rooftop resolved
{
"event_date": "2026-05-18",
"max_estimated_hail_in": 1.75,
"first_hail_at": "20:42Z",
"peak_hail_at": "20:51Z",
"hail_duration_min": 14,
"hail_pass_count": 2,
"nws_hail_reports_zip": 3,
"confidence": "high"
}
Build On It

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.

address-level 2 yr history json / pdf

Common uses

Property hail-history lookups
Roofing and inspection intake
Property review workflows
Post-storm follow-up
Approved customer-facing hail reports
Real estate and home-inspection tools
Internal property dashboards
Built Around the Address

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.

Was qualifying hail estimated at this property? qualifying_hail
What was the maximum estimated hail at the property? max_estimated_hail_in
When did the hail begin, peak, and end? first / peak / last_hail_at
How long did the hail activity last? hail_duration_min
How long did hail stay above selected size thresholds? duration_above_threshold
Were multiple hail passes detected? hail_pass_count
How intense or sustained was the hail activity? cumulative_exposure
What were the hail conditions within 500 meters? local_context_500m
How strong is the available data confidence? confidence

Field names are illustrative. The API provides estimated property-level weather analysis — it does not confirm that hail struck or damaged the property.

Report Products

Three report products

Test all three with deterministic sandbox fixtures. Production keys receive the scopes approved for the integration.

REPORT 2

Property Hail History

Two-year qualifying history with per-date detail.

Maximum estimated hail for each qualifying date
NWS hail report count in the property's ZIP, per date
NWS wind report count in the property's ZIP, per date
REPORT 3

Event Detail

Essential evidence for one selected event.

Maximum estimated hail at the property
First detected, peak, and last detected hail time
Hail duration
NWS hail and wind reports in the property's ZIP
Reported hail size, where applicable
Maximum and typical hail size across the ZIP
Confidence and data-quality information
REPORT 4

Full Event

Event Detail, plus deep metrics.

Duration at selected hail-size thresholds
Mean estimated hail during active periods
Hail pass counts
Cumulative hail exposure metrics
Max continuous duration at thresholds
Local hail context within 500 meters
NWS hail and wind reports within five miles of the property
Distance from the property to each included NWS report
Strong wind reported: yes / no
Reported wind speed, when available
Additional confidence and quality information

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.

How It Works

Address in, report out

1

Submit an address

Your application sends a property address through an authenticated API request.

2

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.

3

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.

4

Check the available hail history

The system checks up to two years of available history for qualifying hail activity associated with the property.

5

Select an event

Choose an available hail date from Property Hail History, then submit that address and date for Event Detail or Full Event.

6

Receive the results

The API returns the property and event information included with your developer access.

7

Use the results in your product

Present the approved information inside your own interface, property record, customer workflow, internal system, or permitted report.

two-call sequence
# 1 — history for the address
POST /v1/reports/business-historical
"address": "4312 Oak Ridge Dr…"
→ "events": [{
"event_date": "2026-05-18" }, … ]
# 2 — detail for one event
POST /v1/reports/event-detail
"address" + "event_date"
→ full event metrics + NWS context

Send the address and selected event date. HailGeeks resolves the private event identity inside the gateway.

What Developers Can Build

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.

Designed For

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.

Roofing and storm-restoration software Roof and property inspection platforms Property technology products Home-inspection systems Real estate applications Insurance technology Home-service platforms Internal property-review tools
Radar and NWS Reports

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

Whether a hail or wind report was present in the property's ZIP
Hail and wind report counts in the property's ZIP
Reported hail size
Reported wind speed, when available
At Full Event only: reports within five miles of the property, and the distance to each one
Responsible Results

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.

Estimated hail vs. confirmed damage
Radar analysis vs. NWS ground reports
Weather analysis vs. physical evidence
A property-level signal vs. a professional inspection
Report metrics vs. a damage determination

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.

Developer Access

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

Intended use
Expected request volume
Required report product and fields
Internal or customer-facing use
Data retention needs
Report display or export requirements
Commercial use

Hail Reports by Address API FAQ

What does the Hail Reports by Address API provide?

The API provides structured hail report information associated with a specific property address. Depending on the approved report product, results may include hail-event dates, maximum estimated hail, event timing, duration, hail pass counts, cumulative exposure metrics, local 500-meter context, confidence information, NWS ground reports, and ZIP-level event statistics.

How much hail history is included?

The API checks up to two years of available hail history for the property. Exact date coverage and event availability are defined in the developer documentation.

Does the API confirm hail damage?

No. The API identifies estimated hail activity and provides property-level storm context. It cannot confirm that hail struck or damaged a specific roof or structure.

Can applications submit an address?

Yes. The API is designed to support property hail reports requested by address. HailGeeks resolves the submitted address to the coordinates used for the property-level analysis.

What happens if the address is not resolved to a rooftop?

The API may identify the location as estimated rather than rooftop-resolved. Applications should preserve that distinction when presenting the results.

Why does HailGeeks validate the ZIP code?

Property-level analysis must be based on the resolved coordinates rather than an unverified caller-supplied ZIP code. HailGeeks independently derives or validates the ZIP used for the report.

How are individual hail events requested?

Historical results provide available hail dates. Applications submit the property address and selected date when requesting Event Detail or Full Event information.

Can results be shown to customers?

Customer-facing use may be approved as part of a developer integration. Available fields, display requirements, and report permissions depend on the developer access provided.

Can results be saved or included in reports?

Storage, export, and report-use permissions depend on the approved integration. API access does not automatically include unrestricted storage, redistribution, bulk publication, or resale of the returned information.

Does the API include NWS reports?

Yes, depending on the report product. Property Hail History and Event Detail include bounded NWS context. Full Event adds deeper nearby evidence. NWS reports are separate storm evidence and do not change the property-level radar analysis.

Can the API determine whether an insurance claim should be filed?

No. The API provides property and storm context. It does not determine damage, insurance coverage, claim eligibility, causation, or repair scope.

Is the API publicly available?

Any eligible HailGeeks account can activate the deterministic, no-charge sandbox immediately. Live production data requires an approved production application.

How do I get API access?

Create a HailGeeks account and activate Sandbox in the Developer API console for immediate test access. Submit this form when you are ready to request Live production access.

How is API pricing determined?

Sandbox fixture calls are free. Live Property Hail History, Event Detail, and Full Event reports use 10, 30, and 60 credits respectively. The approved production request-rate limit appears in the Developer API console.

Production Access

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.

All fields are required

How will the API be used? required
Who will see the results? required
Which report information is needed? required

This is a production-access application. For immediate sandbox access, create an account and activate Sandbox in the Developer API console.