{"uid":"cap_Nb7kCe2_tYzuIv2BrV0PT","slug":"hrsa-hpsa-search-health-professional-shortage-area-lookup-525e631e","name":"HRSA HPSA Search — Health Professional Shortage Area Lookup","description":"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.","url":"https://api.healthparse.io/v1/hpsa/search","method":"GET","headers":{},"bodySchema":{"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)"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","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":"$0.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_j8HRUnNc9yMteqaeuiUS2","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Travel nurse staffing market prioritization","prompt":"Show me the 25 Primary Care Health Professional Shortage Areas across California and Nevada with the highest HPSA scores right now, sorted by score descending — I want to see which areas have the worst shortage so we can prioritize recruiting there."},{"title":"Rural dental clinic site selection","prompt":"Find all currently designated rural Dental Health shortage areas in Georgia and South Carolina that have been designated since 2022-01-01 and need at least 2 FTE dentists — sort by FTE shortage so I see the most critical areas first."},{"title":"Mental health policy gap analysis","prompt":"Give me all Mental Health HPSAs with a minimum HPSA score of 16 across the entire US, sorted by shortage score descending, up to 100 results — I'm mapping the most severely underserved areas for a federal grant proposal."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:36:44.347Z","isFirstParty":false}