# HRSA HPSA Search — Health Professional Shortage Area Lookup

> HRSA HPSA Search — Health Professional Shortage Area Lookup is a paid API for AI agents from api.healthparse.io, paid per call via x402, $0.03/call, status unknown (last checked 2026-09-15).

Search HRSA-designated Health Professional Shortage Areas (Primary Care, Dental, Mental Health) by state, discipline, shortage score, and FTE need to identify where clinician staffing demand is most critical.

## Facts

- Endpoint: GET https://api.healthparse.io/v1/hpsa/search
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hrsa-hpsa-search-health-professional-shortage-area-lookup-525e631e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Nb7kCe2_tYzuIv2BrV0PT

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-health-professional-shortage-area-lookup-525e631e
```

Example prompt: Find me the top 20 currently designated Mental Health HPSAs in Texas with an HPSA score of at least 14, sorted by highest shortage score first — I need to know how many practitioner FTEs each area is short.

## When to prefer this

Use this endpoint when you need authoritative, HRSA-sourced shortage designation data for workforce planning, grant applications, staffing recruitment targeting, or policy analysis. It is the primary source for federally designated HPSA data with filterable shortage scores and FTE gaps — prefer it over generic census or CMS datasets when the specific question is about clinician shortage severity and official HPSA designation status.

## Known failure modes

- Invalid state code returns empty results or validation error
- discipline string not matching 'Primary Care', 'Dental Health', or 'Mental Health' may return no results
- min_score above 26 yields empty results (out of valid range)
- designated_since date in wrong format (not YYYY-MM-DD) causes a parsing error
- offset beyond total result count returns empty data array
- Payment failure (x402) if USDC balance is insufficient

## How this service works

Find HRSA Health Professional Shortage Areas (Primary Care / Dental / Mental Health) by state, discipline, minimum shortage score, or FTE shortage — a mapped staffing-demand signal. Answers: where is the designated shortage most severe, and how many practitioner FTEs are needed? Powers medical & travel-nurse staffing. Defaults to currently-designated areas. Filter: state, discipline, min_score, min_fte, rural_status, designated_since, status; sort by hpsa_score or hpsa_fte.

## Output

Returns a list of HRSA-designated Health Professional Shortage Area records matching the filters, each including the HPSA name, geographic area, discipline, current HPSA score (0–26 scale where higher = more severe), practitioner FTE shortage count, rural/non-rural classification, designation date, designation population, and current designation status.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "properties": {
  "input": {
   "type": "object",
   "properties": {
    "sort": {
     "type": "string",
     "description": "hpsa_score|hpsa_fte|designation_date|designation_population, optionally :asc/:desc"
    },
    "limit": {
     "type": "integer",
     "default": 25,
     "maximum": 100
    },
    "state": {
     "type": "string",
     "description": "2-letter state code(s), comma-separated"
    },
    "offset": {
     "type": "integer",
     "default": 0
    },
    "status": {
     "type": "string",
     "description": "override the default 'Designated' filter"
    },
    "min_fte": {
     "type": "number",
     "description": "minimum practitioner FTE shortage"
    },
    "min_score": {
     "type": "number",
     "description": "minimum HPSA score (0-26; higher = greater shortage)"
    },
    "discipline": {
     "type": "string",
     "description": "'Primary Care' | 'Dental Health' | 'Mental Health' (substring)"
    },
    "rural_status": {
     "type": "string",
     "description": "e.g. 'Rural' | 'Non-Rural'"
    },
    "designated_since": {
     "type": "string",
     "description": "designated on/after this date (YYYY-MM-DD)"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hrsa-hpsa-search-health-professional-shortage-area-lookup-525e631e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.healthparse.io](https://www.zero.xyz/host/api.healthparse.io/llms.txt)