Skip to main content
There are 37 topics. They fall into three groups, and each group returns a different shape in value. Read this before you write parsing code.

Natural

18 topics
value is an object with an NRI rating

Proximity

14 topics
value is a number

Measurements

5 topics
value is a measurement object

Natural (18)

Backed by the FEMA National Risk Index (NRI), which scores hazard risk by US census tract. value is an object:
rating is one of: Very Low · Relatively Low · Relatively Moderate · Relatively High · Very High · No Rating · Insufficient Data · Not Applicable
Not Applicable is common and expected — e.g. avalanche in Manhattan. It means the hazard doesn’t meaningfully apply to that tract, not that the lookup failed.
Topics: Five of these (earthquake, hail, hurricane, tornado, wildfire) pair the NRI rating with a live detail feed. The other 13 return the NRI rating only.

Proximity (14)

Counts of features near the location. value is a plain number.
details is a GeoJSON FeatureCollection of the individual records that were counted — useful if you need the specific sites, not just how many.
A count of 0 is a valid answer — it means no features were found near that location. It is not an error.

Measurements (5)

Each returns a domain-specific object. These do not share a common shape — handle each individually.

airQuality

Annual air quality summary for the county.
details is null.

ozone · pm25 · pm10

Current pollutant concentration at the coordinates.
details is null.
rating is an AreaHub risk rating or an official EPA AQI Category where applicable. For EPA-compliant AQI, compute the AQI from measurement.value — that raw concentration is the authoritative field.

radon

EPA average radon zone designation for the county.
details is null.
The description field is EPA’s standard advisory text. It is identical on every response and does not vary by location.

Which topics are in which bundle?

Any topic can also be requested individually via GET /v1/{slug}/risk for 1 credit.

Update frequency