---
title: "Earthquake Risk"
method: GET
path: "/v2/block/hazard_earthquake"
tags: ["Census Block Level"]
---

# Earthquake Risk

`GET /v2/block/hazard_earthquake`

This endpoint provides information on earthquake risk from the US Geological Survey for a specific block. It returns peak horizontal ground acceleration values with a 10% probability of being exceeded in the next 50 years. Percentile values within the county and entire US are provided for context. 

Source: USGS Data, HouseCanary Analysis 

Pricing Tier: Basic 

Updated: Annually

## Request Query Params

<table><tr><th>Property</th><th>Type</th><th>Description</th><th>Example</th></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>max_percent_g</td><td>number</td><td>Peak horizontal ground acceleration with a 10% probability of being exceeded in the next 50 years. Values are given in %g, where g is acceleration due to gravity, or 9.8 meters/second^2.</td><td>0.45</td>
        </tr>
<tr><td>county_percentile</td><td>integer</td><td>Where the max_percent_g falls within the county. Percentile values range from 0 to 100, with higher values indicating greater risk.</td><td>75</td>
        </tr>
<tr><td>nation_percentile</td><td>integer</td><td>Where the max_percent_g falls within the USA. Percentile values range from 0 to 100, with higher values indicating greater risk.</td><td>60</td>
        </tr>
</table>

## Query parameters

- `block_id` string, required

## Response `200`

Success

- object[]
  - `block/hazard_earthquake` object
    - `api_code_description` string
    - `api_code` unknown
    - `result` object, nullable
      - `max_percent_g` number — Peak horizontal ground acceleration with a 10% probability of being exceeded in the next 50 years. Values are given in %g, where g is acceleration due to gravity, or 9.8 meters/second^2.
      - `county_percentile` integer — Where the max_percent_g falls within the county. Percentile values range from 0 to 100, with higher values indicating greater risk.
      - `nation_percentile` integer — Where the max_percent_g 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)