{"uid":"cap_mfN56jXwXV0kc58alqUcD","slug":"hrsa-hpsa-search-74bec306","name":"HRSA HPSA Search","description":"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.","url":"https://api.govparse.io/v1/hrsa/hpsa/search","method":"GET","headers":{},"bodySchema":{"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."}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"1.25","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$1.25/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"1.25","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"1.25","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_VbTmAyRGccF_tor7zkYHF","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"1.25","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search HRSA Health Professional Shortage Areas (HPSAs) by state, county, discipline, score, and other filters to find federally designated shortage zones","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Telehealth market expansion targeting","prompt":"Show me all designated Primary Care HPSAs in rural Georgia and Alabama with a score of at least 15 — I need the shortage FTE and provider-to-population ratio so we can prioritize markets for our telehealth platform rollout."},{"title":"Clinician staffing sales prospecting","prompt":"Pull the top 25 highest-scoring Dental Health HPSAs nationwide, sorted by HPSA score descending, that are still actively designated — I'm building a target list for our dental staffing agency."},{"title":"Healthcare policy shortage monitoring","prompt":"Find all Mental Health HPSAs in California that have been designated since January 1, 2021 and are still active, focusing on low-income population types — I want to track where new shortage designations are emerging."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:53:16.116Z","isFirstParty":false}