FireRiskResponse

Complete fire risk API response. Used by: GET/POST /v1/fire-risk

location_info objectnullable

Geocoded location information

formatted_addressFormatted Address (string)nullable

street_addressStreet Address (string)nullable

cityCity (string)nullable

stateState (string)nullable

state_codeState Code (string)nullable

countyCounty (string)nullable

postal_codePostal Code (string)nullable

latitudeLatitude (number)nullable

longitudeLongitude (number)nullable

geohash8Geohash8 (string)nullable

fire_risk objectrequired

Fire risk assessment data

has_fire_riskHas Fire Risk (boolean)required

Whether fire risk data exists for this location

risk_valueRisk Value (number)nullable

Raw burn probability value (0-1 scale)

risk_levelRisk Level (integer)

Numeric risk level (0-11)

Possible values: >= 0 and <= 11

Default value: 0

risk_categoryRisk Category (string)required

Risk category name (snake_case)

Example: moderate

risk_category_displayRisk Category Display (string)required

Human-readable risk category

Example: Moderate

descriptionDescription (string)required

Detailed risk description

data_sourceData Source (string)nullable

Data source attribution

Default value: USDA Forest Service

annual_chanceAnnual Chance (string)nullable

Annual fire chance (e.g., '1-in-1,000')

return_period_yearsReturn Period Years (integer)nullable

Expected years between fire events

location objectnullable

Query location coordinates

latitudeLatitude (number)required

longitudeLongitude (number)required

FireRiskResponse

{
  "location_info": {
    "formatted_address": "789 Hillside Rd, Boulder, CO 80302",
    "latitude": 40.015,
    "longitude": -105.27
  },
  "fire_risk": {
    "has_fire_risk": true,
    "risk_value": 0.0032,
    "risk_level": 7,
    "risk_category": "high",
    "risk_category_display": "High",
    "description": "High wildfire risk area. Annual burn probability 1-in-312.",
    "annual_chance": "1-in-312",
    "return_period_years": 312,
    "data_source": "USDA Forest Service"
  }
}