---
title: "GeoHealth risk index for a US ZIP / ZCTA"
method: GET
path: "/v1/geohealth/{zip}"
tags: ["Products"]
---

# GeoHealth risk index for a US ZIP / ZCTA

`GET /v1/geohealth/{zip}`

## Request

- Base URL: `https://api.alpinedataworks.com`
- URL: `https://api.alpinedataworks.com/v1/geohealth/{zip}`
- Auth: HTTP bearer

## Path parameters

- `zip` string, required

## Response `200`

GeoHealth IOM object

- IntelligenceObject: Alpine Intelligence Object Manifest (IOM) v0.1. Field depth depends on caller tier: Free (score/trend/freshness only), Gold (+drivers/confidence/history endpoint), Platinum (all fields).
  - `product_id` string, required
  - `entity` string, required
  - `score` union, required: Headline metric
    - number
    - string
  - `trend` string: Direction vs prior period
  - `confidence` number, required
  - `top_drivers` Driver[], required: Ranked factors explaining the score (Gold+ only)
    - `factor` string, required: Named driver of the score
    - `contribution` union, required: Numeric weight or label contribution
      - number
      - string
  - `prediction_horizon` string
  - `recommended_use` string
  - `methodology_version` string, required
  - `freshness` string, date-time, required
  - `coverage` string
  - `source_lineage` string[]
  - `allowed_use` string

## Other responses

- `401`: Unauthorized
- `404`: ZIP/ZCTA not found

---

[API](https://skmtc.dev/alpinedataworks/apis/alpinedataworks-ai-intelligence-object-api.md) · [All operations](https://skmtc.dev/alpinedataworks/apis/alpinedataworks-ai-intelligence-object-api/llms.txt) · [OpenAPI document](https://skmtc.dev/alpinedataworks/apis/alpinedataworks-ai-intelligence-object-api/revisions/2047a24a8648?raw)