What you can build
Primary care, dental and mental health shortage designations; population and facility scope remain explicit. Use this dataset as a sourced input to an application, analytical model or retrieval tool. Retain its native dimensions when joining it with your own records.
Query HRSA Health Professional Shortage Areas
The example below is a real bounded request against the available release. Replace the environment variable with your server-side API credential. Review endpoint parameters and response schemas before changing selectors.
curl --fail --get "https://api.geoamcan.com/v1/designations?dataset=hrsa-hpsa&limit=1&designation_id=DH%3A106999060T" \
-H "Authorization: Bearer $GEOAMCAN_API_KEY"Saved response excerpt
{
"source_attribution": {
"hrsa-hpsa": "HRSA — HRSA Health Professional Shortage Areas; https://data.hrsa.gov/data/download?titleFilter=Shortage+Areas; official source snapshots, no endorsement implied."
},
"requested_area": {
"include_geometry": false,
"dataset": "hrsa-hpsa",
"lat": null,
"lon": null,
"geo_type": null,
"geoid": null,
"vintage": null,
"designation_id": "DH:106999060T",
"area": null
},
"data": [
{
"dataset": "hrsa-hpsa",
"source": "HRSA",
"release": "HRSA snapshot 4351a4a54530 parser v2 revision 73adc9289aaa",
"geographic_resolution": "population",
"geoid": "DH:106999060T",
"geography_vintage": "source_geometry",
"period": "10/29/2026",
"naics": "",
"component": "record:11fadedc823060dd2aa33d82",
"metrics": {},
"margins_of_error": {},
"flags": {
"scope": "population",
"record": {
"dates": {
"Withdrawn Date": "10/04/2010",
"HPSA Designation Date": "09/01/2010",
"HPSA Withdrawn Date String": "2010/10/04",
"Data Warehouse Record Create Date": "10/29/2026",
"HPSA Designation Last Update Date": "10/04/2010",
"Data Warehouse Record Create Date Text": "2026/10/29"
},
"source_url": "https://data.hrsa.gov/DataDownload/DD_Files/BCD_HPSA_FCT_DET_DH.csv",
"source_record": {
"HPSA ID": "106999060T",
"HPSA FTE": "1.2000",
"Latitude": "",
"HPSA City": "",
"HPSA Name": "Low Inc - MSSAs 72, 74 & 75 (Susanville/Honeylake)",
"Longitude": "",
"HPSA Score": "0",
"State Name": "California",
"HPSA Status": "Withdrawn",
"HPSA Address": "",
"Rural Status": "Rural",
"HPSA Shortage": "1.1000"
},
"designation_type": "HPSA Population",
"reference_period": "10/29/2026"
},
"source_status": "Withdrawn",
"designation_id": "DH:106999060T",
"source_component": {
"source_record": {
"HPSA ID": "106999060T",
"HPSA FTE": "1.2000",
"Latitude": "",
"HPSA City": "",
"HPSA Name": "Low Inc - MSSAs 72, 74 & 75 (Susanville/Honeylake)",
"Longitude": "",
"HPSA Score": "0",
"State Name": "California",
"HPSA Status": "Withdrawn",
"HPSA Address": "",
"Rural Status": "Rural",
"HPSA Shortage": "1.1000"
}
},
"geometry_available": false,
"jurisdiction": {
"scope": "US",
"source_state_fips": "06",
"source_name": "California"
}
}
}
],
"availability": {
"hrsa-hpsa": {
"status": "matches",
"coverage": "US coverage; HRSA additionally retains separately labeled non-US source jurisdictions and unknown source jurisdiction markers. No Canadian equivalent layers.",
"release_metadata": {
"passed": true,
"country": "US coverage; separately labeled non-US source jurisdictions and unknown source jurisdiction markers retained",
"records": 42857,
"components": {
"n": 202168,
"native_geometries": 32215
},
"retrieved_at": "2026-10-30T02:29:40.912752+00:00",
"validated_at": "2026-10-30T02:29:34.681643+00:00",
"coverage_gaps": [
"10642 designation records have no published/compatible spatial geometry; see status-specific counts"
],
"geometry_repairs": 15,
"row_storage_bytes": 82448064,
"designation_counts": [
{
"scope": "facility",
"status": "Designated",
"records": 14754
}
],
"source_attribution": "HRSA — HRSA Health Professional Shortage Areas; https://data.hrsa.gov/data/download?titleFilter=Shortage+Areas; official source snapshots, no endorsement implied.",
"published_jurisdictions": [
{
"records": 607,
"source_state_fips": "01"
}
]
},
"interpretation": "Geographic overlap is not full-area designation or business/project/funding eligibility. Population conditions apply; facility matches do not designate surrounding areas."
}
},
"next_offset": 1,
"returned_count": 1,
"complete": false,
"snapshot": {
"hrsa-hpsa": {
"release_id": 81,
"release": "HRSA snapshot 4351a4a54530 parser v2 revision 73adc9289aaa",
"fingerprint": "94c55a8b2b231e14856e4dc2fc4fb865"
},
"tiger": {
"release_id": 1,
"release": "2026 + native 2024/2020",
"fingerprint": "0400658a689c0c2b04db479935dae54a"
},
"geography-extended": {
"release_id": 29,
"release": "2026 + native 2024",
"fingerprint": "e63402f6d0af12bc02df1e39a93b9fb8"
},
"designation-boundaries": {
"release_id": 62,
"release": "2010 native tracts + 2020 Island Areas parser v1",
"fingerprint": "c15cd69ac14013bea7024a09f5902f17"
}
},
"metric_definitions": {
"hrsa-hpsa": {
"DD_HPSA_METADATA_VX:0": {
"label": "Attribute Name",
"unit": "source-defined",
"universe": null,
"source_definition": {
"source_row": [
"Attribute Name"
],
"source_url": "https://data.hrsa.gov/DataDownload/DD_Files/HPSA_DATAMART_METADATA.XLSX"
}
},
"DD_HPSA_METADATA_VX:1": {
"label": "Congressional District Name",
"unit": "source-defined",
"universe": null,
"source_definition": {
"source_row": [
"Congressional District Name"
],
"source_url": "https://data.hrsa.gov/DataDownload/DD_Files/HPSA_DATAMART_METADATA.XLSX"
}
},
"DD_HPSA_METADATA_VX:8": {
"label": "Contact Telephone Number",
"unit": "source-defined",
"universe": null,
"source_definition": {
"source_row": [
"Contact Telephone Number"
],
"source_url": "https://data.hrsa.gov/DataDownload/DD_Files/HPSA_DATAMART_METADATA.XLSX"
}
},
"DD_HPSA_METADATA_VX:2": {
"label": "State FIPS Code",
"unit": "source-defined",
"universe": null,
"source_definition": {
"source_row": [
"State FIPS Code"
],
"source_url": "https://data.hrsa.gov/DataDownload/DD_Files/HPSA_DATAMART_METADATA.XLSX"
}
},
"DD_HPSA_METADATA_VX:3": {
"label": "State Name",
"unit": "source-defined",
"universe": null,
"source_definition": {
"source_row": [
"State Name"
],
"source_url": "https://data.hrsa.gov/DataDownload/DD_Files/HPSA_DATAMART_METADATA.XLSX"
}
},
"DD_HPSA_METADATA_VX:4": {
"label": "U.S. Senator Name (2)",
"unit": "source-defined",
"universe": null,
"source_definition": {
"source_row": [
"U.S. Senator Name (2)"
],
"source_url": "https://data.hrsa.gov/DataDownload/DD_Files/HPSA_DATAMART_METADATA.XLSX"
}
},
"DD_HPSA_METADATA_VX:5": {
"label": "Data Warehouse Record Create Date",
"unit": "source-defined",
"universe": null,
"source_definition": {
"source_row": [
"Data Warehouse Record Create Date"
],
"source_url": "https://data.hrsa.gov/DataDownload/DD_Files/HPSA_DATAMART_METADATA.XLSX"
}
},
"DD_HPSA_METADATA_VX:6": {
"label": "Site Postal Code",
"unit": "source-defined",
"universe": null,
"source_definition": {
"source_row": [
"Site Postal Code"
],
"source_url": "https://data.hrsa.gov/DataDownload/DD_Files/HPSA_DATAMART_METADATA.XLSX"
}
},
"DD_HPSA_METADATA_VX:7": {
"label": "UDS Number",
"unit": "source-defined",
"universe": null,
"source_definition": {
"source_row": [
"UDS Number"
],
"source_url": "https://data.hrsa.gov/DataDownload/DD_Files/HPSA_DATAMART_METADATA.XLSX"
}
},
"DD_HPSA_METADATA_VX:9": {
"label": "Contact E-mail",
"unit": "source-defined",
"universe": null,
"source_definition": {
"source_row": [
"Contact E-mail"
],
"source_url": "https://data.hrsa.gov/DataDownload/DD_Files/HPSA_DATAMART_METADATA.XLSX"
}
},
"DD_HPSA_METADATA_VX:10": {
"label": "Site Name",
"unit": "source-defined",
"universe": null,
"source_definition": {
"source_row": [
"Site Name"
],
"source_url": "https://data.hrsa.gov/DataDownload/DD_Files/HPSA_DATAMART_METADATA.XLSX"
}
},
"DD_HPSA_METADATA_VX:11": {
"label": "Urban Rural Description",
"unit": "source-defined",
"universe": null,
"source_definition": {
"source_row": [
"Urban Rural Description"
],
"source_url": "https://data.hrsa.gov/DataDownload/DD_Files/HPSA_DATAMART_METADATA.XLSX"
}
}
}
},
"coverage_limitations": {
"hrsa-hpsa": [
"10642 designation records have no published/compatible spatial geometry; see status-specific counts"
]
},
"native_area_contexts": {},
"commuting_flows": []
}Captured 2026-11-03. Excerpt omits pagination credentials and may shorten nested records. Download verified source responses.
Coverage and interpretation
Coverage is limited to published source geographies and releases. Missing, suppressed and unavailable observations must not be treated as zero.
The active release shown here is a catalog snapshot. Check the live catalog and response provenance for current readiness. The underlying public source and Geoamcan access terms are separate; consult the source’s licensing and attribution requirements.
Source and methodology
Source: HRSA. Geoamcan is an independent API provider, with no agency affiliation or endorsement. Read our data methodology for source handling, geographic joins and update practices.
Related data
- TIGER/Line Geographic Boundaries
- US Political District Boundaries
- US School District Boundaries
- US Census 2020 Voting Districts
Put this data to work.
Tell us about your application, coverage needs and expected API usage.
Get API access ↗Read integration guides