U. S. Department of Health & Human Services
Search

Web Services Developer Guide

The web service endpoint is: https://datawarehouse.hrsa.gov/HDWDataServiceExternal/HdwDataWebServiceExternal.asmx?WSDL

The HDW web services provide data for two data sets:

 

Health Center Data Service Detail

Two web methods are available for Health Center Data: FindHealthCentersByArea and FindHealthCentersAroundALocation. The parameters for FindHealthCentersByArea web method are:

  • StateFIPSCode – State FIPS code
  • CountyFIPSCode – County FIPS code
  • ZipCode – ZIP code
  • WhereClause – Additional filter for the results
  • Token – Organization token provided by HDW

The parameters for FindHealthCentersAroundALocation web method are:

  • Longitude – Geographic coordinate that specifies the east-west position of a point on the Earth's surface
  • Latitude – Geographic coordinate that specifies the north-south position of a point on the Earth's surface
  • SearchRadiusInMiles – Search radius in miles
  • MinimumRecordCount – Minimum number of health centers requested
  • ExpandRadiusbyMiles – Expand search radius in miles; used if number of health centers found within the provided search radius are less than the minimum number of Health Centers requested
  • maxRadius – Maximum search radius in miles
  • Token – Organization token provided by HDW

Health Center Data Sample Result

<HCC>
<HCC>
<Row_ID>21</Row_ID>
<SITE_NM>Community Healthcare Center - Juarez Medical Clinic</SITE_NM>
<SITE_URL>www.chcwf.com</SITE_URL>
<HCC_FCT_ID>3025</HCC_FCT_ID>
<SITE_ADDRESS>1000 Juarez St Bldg A</SITE_ADDRESS>
<SITE_CITY>WICHITA FALLS</SITE_CITY>
<STATE_NM>Texas</STATE_NM>
<SITE_STATE_ABBR>TX</SITE_STATE_ABBR>
<SITE_ZIP_CD>76301-6905</SITE_ZIP_CD>
<SITE_PHONE_NUM>940-766-6306</SITE_PHONE_NUM>
<HCC_LOC_DESC>Permanent</HCC_LOC_DESC>
<HCC_TYP_DESC>Service Delivery Site</HCC_TYP_DESC>
<DW_RECORD_CREATE_DT>11/2/2012 12:00:00 AM</DW_RECORD_CREATE_DT>
<APPROX_VALUE_CD>N.</APPROX_VALUE_CD>
<LAT_LON>33.9122454545454 -98.4738090909091</LAT_LON>
<Distance>2.77</Distance>
</HCC>
<HCC>
<Row_ID>7</Row_ID>
<SITE_NM>NORTH CENTRAL TX COMMUNITY HEALTH CARE</SITE_NM>
<SITE_URL>www.chcwf.com</SITE_URL>
<HCC_FCT_ID>2934</HCC_FCT_ID>
<SITE_ADDRESS>200 Mlk Jr Blvd</SITE_ADDRESS>
<SITE_CITY>WICHITA FALLS</SITE_CITY>
<STATE_NM>Texas</STATE_NM>
<SITE_STATE_ABBR>TX</SITE_STATE_ABBR>
<SITE_ZIP_CD>76301-1152</SITE_ZIP_CD>
<SITE_PHONE_NUM>940-766-6306</SITE_PHONE_NUM>
<HCC_LOC_DESC>Permanent</HCC_LOC_DESC>
<HCC_TYP_DESC>Administrative/Service Delivery Site</HCC_TYP_DESC>
<DW_RECORD_CREATE_DT>11/2/2012 12:00:00 AM</DW_RECORD_CREATE_DT>
<APPROX_VALUE_CD>Y</APPROX_VALUE_CD>
<LAT_LON>33.9038 -98.4816363636364</LAT_LON>
<Distance>3.09</Distance>
</HCC>
</HCC>

Ryan White HIV/AIDS Medical Providers Data Service Detail

The web method available for Ryan White HIV/AIDS Medical Providers Data: FindHIVAIDSCareProvidersAroundALocation. The parameters for FindHIVAIDSCareProvidersAroundALocation web method are:

  • Filter – Filter for the results
  • LatitudeLongitude – Latitude and longitude for the location to search around
  • SearchRadiusInMiles – Search radius in miles
  • MinimumRecordCount – Minimum number of HIV AIDS Care Providers requested
  • MaximumSearchRadiusInMiles – Maximum search radius in miles
  • ExpandRadiusbyMiles – Expand search radius in miles; used if number of HIV/AIDS care providers found within the provided search radius are less than the mimimum number of HIV/AIDS care providers requested.
  • Token – Organization token provided by HDW

Ryan White HIV/AIDS Medical Providers Data Sample Result

<HAB>
<HAB>
<Row_ID>4</Row_ID>
<HAB_SITE_ID>1596</HAB_SITE_ID>
<PROVIDER_NM>Opis HIV-AIDS Clinic</PROVIDER_NM>
<PROVIDER_ADDR>2 Upper Ragsdale Dr Ste D200</PROVIDER_ADDR>
<PROVIDER_CITY>Monterey</PROVIDER_CITY>
<PROVIDER_STATE_ABBR>CA</PROVIDER_STATE_ABBR>
<PROVIDER_ZIP_CD>93940-7839</PROVIDER_ZIP_CD>
<PROVIDER_PHONE_NUM>831-625-4972</PROVIDER_PHONE_NUM>
<URL>No Website available at this time</URL>
<DW_RECORD_CREATE_DT>3/1/2011 12:00:00AM</DW_RECORD_CREATE_DT>
<APPROX_VALUE_CD>N</APPROX_VALUE_CD>
<LAT_LON>36.5767545454545 -121.818927272727</LAT_LON>
<Distance>13.97</Distance>
</HAB>
<HAB>
<Row_ID>5</Row_ID>
<HAB_SITE_ID>1597</HAB_SITE_ID>
<PROVIDER_NM>Opis HIV-AIDS Clinic Outpatient Immunology Services</PROVIDER_NM>
<PROVIDER_ADDR>2 Upper Ragsdale Dr Ste D200</PROVIDER_ADDR>
<PROVIDER_CITY>Monterey</PROVIDER_CITY>
<PROVIDER_STATE_ABBR>CA</PROVIDER_STATE_ABBR>
<PROVIDER_ZIP_CD>93940-7839</PROVIDER_ZIP_CD>
<PROVIDER_PHONE_NUM>831-625-4972</PROVIDER_PHONE_NUM>
<URL>No Website available at this time</URL>
<DW_RECORD_CREATE_DT>3/1/2011 12:00:00 AM</DW_RECORD_CREATE_DT>
<APPROX_VALUE_CD>N</APPROX_VALUE_CD>
<LAT_LON>36.5767545454545 -121.818927272727</LAT_LON>
<Distance>13.97</Distance>
</HAB>
</HAB>