# HRSA HPSA Search

> HRSA HPSA Search is a paid API for AI agents from api.govparse.io, paid per call via x402, $1.25/call, status unknown (last checked 2026-09-14).

Search HRSA Health Professional Shortage Areas (HPSAs) by state, county, discipline, score, and other filters to find federally designated shortage zones

## Facts

- Endpoint: GET https://api.govparse.io/v1/hrsa/hpsa/search
- Price: $1.25/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hrsa-hpsa-search-74bec306
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_mfN56jXwXV0kc58alqUcD

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability hrsa-hpsa-search-74bec306
```

Example prompt: Find all designated Mental Health HPSAs in Texas with a minimum HPSA score of 18, including rural-only areas, sorted by score descending — I need the shortage FTE and provider-to-population ratio for each.

## When to prefer this

Use this endpoint when you need structured, filterable access to HRSA HPSA designation data — especially for identifying geographic shortage zones by discipline and severity score. Prefer this over manual HRSA web portal lookups when automating clinician staffing prospecting, telehealth market analysis, or healthcare policy research. It complements the HRSA MUA/P search endpoint (which covers medically underserved areas broadly) but is specifically focused on provider-type shortages with HPSA scores.

## Known failure modes

- No results returned when filter combination is too restrictive or state/county name is misspelled
- Invalid discipline or status values return an error or empty set
- min_score values outside 0-26 range may return an error
- Stale data if HRSA has not updated underlying dataset recently
- Rate limiting or payment failure under x402 protocol returns 402 Payment Required

## How this service works

Where has the federal government designated a health-professional shortage? Search HRSA HPSAs by state, county, discipline (Primary Care | Dental Health | Mental Health), designation type, status, minimum HPSA score (0-26, higher = worse), population type, rural-only, or designated-since date. Returns the designation, score, geography, provider-to-population ratio, and shortage FTE — the buying moment for clinician-staffing, telehealth, and workforce vendors.

## Output

Returns a list of HPSA records each containing the designation name, HPSA ID, HPSA score (0-26), discipline, designation type, current status, geographic identifiers (state, county), population type, provider-to-population ratio, shortage FTE, and designation date.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "properties": {
  "input": {
   "type": "object",
   "required": [],
   "properties": {
    "sort": {
     "type": "string",
     "examples": [
      "score:desc"
     ],
     "description": "score | designation_date | shortage_fte :asc|:desc. Default score:desc."
    },
    "limit": {
     "type": "integer",
     "examples": [
      25
     ],
     "description": "Max rows (default 25, cap 100)."
    },
    "rural": {
     "type": "string",
     "examples": [
      "true"
     ],
     "description": "true = rural / partially-rural only; false = non-rural."
    },
    "since": {
     "type": "string",
     "examples": [
      "2020-01-01"
     ],
     "description": "Designated on or after this date (YYYY-MM-DD)."
    },
    "state": {
     "type": "string",
     "examples": [
      "TX"
     ],
     "description": "Primary state/territory code(s), CSV."
    },
    "county": {
     "type": "string",
     "examples": [
      "Harris"
     ],
     "description": "County name fragment."
    },
    "offset": {
     "type": "integer",
     "examples": [
      0
     ],
     "description": "Rows to skip."
    },
    "status": {
     "type": "string",
     "examples": [
      "Designated"
     ],
     "description": "Designated | Proposed for Withdrawal | Withdrawn (CSV)."
    },
    "hpsa_id": {
     "type": "string",
     "examples": [
      "1484203330"
     ],
     "description": "Exact HPSA ID."
    },
    "min_score": {
     "type": "string",
     "examples": [
      "18"
     ],
     "description": "Minimum HPSA score (0-26, higher = worse)."
    },
    "discipline": {
     "type": "string",
     "examples": [
      "Primary Care"
     ],
     "description": "Primary Care | Dental Health | Mental Health (CSV)."
    },
    "population_type": {
     "type": "string",
     "examples": [
      "Low Income"
     ],
     "description": "Population-type fragment (Low Income, Migrant Farmworker...)."
    },
    "designation_type": {
     "type": "string",
     "examples": [
      "Geographic HPSA"
     ],
     "description": "Designation type fragment."
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hrsa-hpsa-search-74bec306/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.govparse.io](https://www.zero.xyz/host/api.govparse.io/llms.txt)