---
title: "Hail Activity (Batch)"
method: POST
path: "/v2/block/hazard_hail"
tags: ["Census Block Level"]
---

# Hail Activity (Batch)

`POST /v2/block/hazard_hail`

Obtain a historical overview of hailstorm activity near a block, with percentile rankings for county and US comparison. Data sourced from the National Oceanic and Atmospheric Administration. 

Source: NOAA Data, HouseCanary Analysis 

Pricing Tier: Basic 

Updated: Annually

## Request Body Fields

<table><tr><th>Field</th><th>Type</th><th>Description</th><th>Example</th></tr>
<tr><td>[]</td><td>object</td><td></td><td></td>
        </tr>
<tr><td>[].block_id</td><td>string</td><td>15-digit US-census block ID</td><td>360050001001000</td>
        </tr>
</table>

## Response

<table><tr><th>Field</th><th>Type</th><th>Description</th><th>Example</th></tr>
<tr><td>accumulated_energy</td><td>number</td><td>Estimated total accumulated energy from all hailstorms recorded near the block.</td><td>3500.75</td>
        </tr>
<tr><td>county_percentile</td><td>integer</td><td>Where the accumulated energy score falls within the county. Percentile values range from 0 to 100, with higher values indicating greater risk.</td><td>80</td>
        </tr>
<tr><td>nation_percentile</td><td>integer</td><td>Where the accumulated energy score falls within the USA. Percentile values range from 0 to 100, with higher values indicating greater risk.</td><td>70</td>
        </tr>
</table>

## Request body

- object[]
  - `block_id` string, required — 15-digit US-census block ID

## Response `200`

Success

- object[]
  - `block/hazard_hail` object
    - `api_code_description` string
    - `api_code` unknown
    - `result` object, nullable
      - `accumulated_energy` number — Estimated total accumulated energy from all hailstorms recorded near the block.
      - `county_percentile` integer — Where the accumulated energy score falls within the county. Percentile values range from 0 to 100, with higher values indicating greater risk.
      - `nation_percentile` integer — Where the accumulated energy score falls within the USA. Percentile values range from 0 to 100, with higher values indicating greater risk.
  - `block_info` BlockInfo
    - `block_id` string, nullable — 15-digit US-census block ID

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `429` — Rate limit exceeded

---

[API](https://skmtc.net/housecanary/apis/housecanary-analytics-and-portfolio-monitoring-apis.md) · [All operations](https://skmtc.net/housecanary/apis/housecanary-analytics-and-portfolio-monitoring-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/housecanary/housecanary-analytics-and-portfolio-monitoring-apis/revisions/38afb6724de7/schema)