Api Endpoint

api.healthparse.io

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.

Open interactive test console

Offering

Provider: api.healthparse.io
Method: GET
Offering type: Api Endpoint
Transport type: http
Category: Health And Medicine
Delivery: Not provided
Pricing model: Not provided
x402 version: 2

Endpoint context

URL: https://api.healthparse.io/v1/hpsa/search
MIME type: application/json
First seen: 2026-10-16T01:58:26.121Z
Last seen: 2026-11-02T00:58:53.643Z
Tags: None supplied

Website

Payment pricing

x402 payment terms are the authoritative price for calling this endpoint.

Payment option 1: 0.03 USDC
Atomic price: 30000 · Network: eip155:8453 · Asset: USDC · Scheme: exact

Raw x402 terms

[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "30000",
    "payTo": "0x177eA123A35253ba8869A7e21E717978e482351D"
  }
]

Observed health

Status: Healthy
Latest latency: 1045 ms
Average latency: 607 ms
HTTP status: 402
Last checked: 2026-11-02T00:58:53.635Z
Reachability: 100% over 14 checks

Latency is measured to the first response headers. A reachable result does not verify response accuracy or merchant identity.

Input schema

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

Output schema

{
  "type": "json",
  "example": {
    "records_notice": "Observational roster of HRSA Health Professional Shortage Area designations. One row per HPSA component (facility/geography) per discipline; a higher hpsa_score (0-26) and larger hpsa_fte shortage indicate greater designated shortage — a staffing-demand signal, not a judgment about any provider.",
    "total_matched": 1,
    "rows": [
      {
        "hpsa_id": "1123456789",
        "hpsa_name": "Low Income - Duval County",
        "discipline_class": "Primary Care",
        "hpsa_score": 18,
        "status": "Designated",
        "hpsa_fte": 12.5,
        "primary_state": "FL",
        "county_name": "Duval",
        "designation_date": "2018-06-01"
      }
    ]
  }
}