v1

latestSwagger 2.0U.S. Public Domain License2026-07-148566.5 KB
Safe Drinking Water

Safe Drinking Water Act (SDWA) Systems Search Service

Returns an array of public water systems that meet the specified search criteria.

get/sdw_rest_services.get_systems

Query parameters

output'JSONP' | 'JSON' | 'XML'

Output Format Flag. Enter one of the following keywords:

  • JSON = Data model formatted as Javascript Object Notation (default).
  • JSONP = Data model formatted as Javascript Object Notation with Padding.
  • XML = Data model formatted as Extensible Markup Language.
p_fnstring

Facility Name Filter. Enter one or more case-insensitive facility names to filter results. Provide multiple values as a comma-delimited list. See p_fntype for additional modifiers.

p_ctstring

Facility City Filter. Enter a single case-insensitive city name to filter results.

p_costring

Facility County Filter. Provide a single county name in combination with a state value provided via p_st.

p_fipsstring

FIPS Code Filter. Enter a single 5-character Federal Information Processing Standards (FIPS) state + county value to restrict results. E.g. to limit results to Kenosha County, Wisconsin, use 55059.

p_ststring

Facility State and State-Equivalent Filter. Provide one or more USPS postal abbreviations for states and state-equivalents to filter results. Provide multiple values as a comma-delimited list.

p_zipstring

5-Digit ZIP Code Filter. Provide one or more 5-digit postal zip codes to filter results. May contain multiple comma-separated values.

p_reg'01' | '02' | '03' | '04' | '05' | '06' | '07' | '08' | '09' | '10'

EPA Region Filter. Provide a single value of 01 thru 10 to restrict results to a single EPA region.

p_trbstring

Tribe name

p_act'Y' | 'N' | 'A'

Active Permits/Facilities Flag. Provide Y or N to filter results to facilities with active permits.

p_qiv'0' | 'GT1' | 'GT2' | 'GT4' | 'GT8' | '12'

Quarters in Noncompliance Limiter. Enter a coded value to limit results to facilities with given quarter of noncompliance.

  • Z = Zero quarters in noncompliance.
  • GEXX = Replacing XX with a numeric value, that number of quarterd or more in noncompliance.
  • GTXX = Replacing XX with a numeric value, more than that number of quarters in noncompliance.
p_ico'Y' | 'N'

Indian Country Flag. Enter a "Y" or "N" to restrict searches to facilities inside or outside Indian Country.

p_pidstring

Nine-digit permit IDs. May contain up to 2000 comma-separated values.

p_owop'F' | 'S' | 'L' | 'M' | 'N' | 'P'

Owner/Operator code filter. Enter one of the following codes to filter results:

  • F = Federal Government
  • S = State Government
  • L = Local Government
  • M = Public/Private
  • N = Native American
  • P = Private
p_systyp'CWS' | 'NCWS' | 'NTCWS' | 'TNCWS'

Type of public water system:

  • CWS=Community water system
  • NCWS=Non-community water system
  • NTCWS=Non-transient non-community water system
  • TNCWS=Transient non-community water system
p_swtyp'SW' | 'GW' | 'GU' | 'SWP' | 'GWP' | 'GUP'

Source Water Type:

  • SW = Surface water
  • GW= Ground water
  • GU = Ground water under direct influence of (UDI) surface water
  • SWP = Purchased Surface water
  • GWP = Purchased Ground water
  • GUP = Purchased Ground water UDI surface water
p_popsvstring

Estimated average daily population served by a system:

  • LE500 = 500 or less
  • IN501_3K = 501-3,300
  • IN3K_10K = 3,301-10,000
  • IN10K_100K = 10,001-100,000
  • IN100K_1M = 100,001-1,000,000
  • GT1M = More than 1,000,000 May contain multiple comma-separated values.
p_cntysvstring
p_csstring

Current violations:

  • M = Monitoring and Reporting Violations
  • H = Health-based Violations
  • O = Other Violations
  • P = Public Notice Violations
  • S = Serious Violator
  • N = No Violations May contain multiple comma-separated values.
p_mr'Y' | 'N'

Monitoring and Reporting Violations (failure to conduct regular monitoring of drinking water quality or submit monitoring results in a timely fashion).

p_health'Y' | 'N'

Violations of health-based drinking water standards (maximum contaminant levels, maximum residual disinfectant levels, or treatment technique rules).

p_other'Y' | 'N'

Other violations, such as failing to issue annual consumer confidence reports or maintain required records.

p_pn'Y' | 'N'

Public Notice Violations (failure to immediately alert consumers of serious problem with drinking water).

p_sv'Y' | 'N'

Serious Violator (unresolved serious, multiple, and/or continuing violations). A value of Y will return only SDWIS systems that are Serious Violators, while a value of N will only return SDWIS Systems that are not Serious Violators.

p_qsstring

Quick Search. Allows entry for city, state, and/or zip code.

p_sfsstring

Single Facility Search Filter. Provide a facility name or program system identifier to limit results. For the all data search, the FRS registry identifier is also searched.

p_pswpolstring

For CWA, pollutant names for surface water discharges. for Drinking Water, SDWIS Violation contaminant codes for unaddressed violations that have occurred in the last 3 years. May contain multiple comma-separated values.

p_pswvio'Y' | 'N'

Used in conjuction with parameters p_pswpol and p_pswparam, indicates whether search should only include pollutants with violations.

p_pbalestring

Lead Action Level Exceedance. A "Y" value will select water systems with at least 1 Lead Action Level Exceedance.

p_cualestring

Copper Action Level Exceedance. A "Y" value will select water systems with at least 1 Copper Action Level Exceedance.

p_rc350vstring

Rule code 350 violation. A "Y" value will select water systems with at least one rule code 350 violation.

p_pbvstring

Lead Violations. A "Y" value will select water systems with at least 1 Lead Violation.

p_cuvstring

Copper Violation. A "Y" value will select water systems with at least 1 Copper Violation.

p_lcrvstring

Lead or Copper rule violations. A "Y" value will select water systems with at least 1 Lead or Copper Rule Violation.

p_fea'W' | 'N'

Formal Enforcement Actions [within / not within] specified date range indicator. The date range is determined by parameters p_fead1 and p_fead2 or by parameter p_feay.

  • W = within date range
  • N = not within date range
p_feay1 | 2 | 3 | 4 | 5

Years (1 to 5) Range. This value is used to create a date range for Formal Enforcement Actions (FEA). Used along with p_fea (which indicates whether to look within or outside of the date range) to find FEAs within (or not within) the number of years specified.

p_feaa'A' | 'E' | 'S'

Agency associated with Formal Enforcement Actions:

  • E = EPA
  • S = State
  • A = All
p_iea'W' | 'N'

Informal Enforcement Actions [within / not within] specified date range. The date range is determined by parameters p_iead1 and p_iead2 or by parameter p_ieay.

  • W = within date range
  • N = not within date range
p_ieay1 | 2 | 3 | 4 | 5

Years (1 to 5) Range. This value is used to create a date range for Informal Enforcement Actions (IEA). Used along with p_iea (which indicates whether to look within or outside of the date range) to find IEAs within (or not within) the number of years specified.

p_ieaa'E' | 'S'

Agency associated with Informal Enforcement Actions. If left blank, both agencies are included.

  • E = EPA
  • S = State
p_qis'Z' | 'GE1' | 'GT1' | 'GE2' | 'GT2' | 'GE4' | 'GT4' | 'GE8' | 'GT8' | 'GE12' | 'GT12' | '12'

Significant Quarters in Noncompliance Limiter. Enter one of the following codes to limit results to facilities having given quarters of noncompliance.

  • Z = Zero quarters in noncompliance.
  • GE1 = One or more quarters in noncompliance.
  • GT1 = More than one quarters in noncompliance.
  • GE2 = Two or more quarters in noncompliance.
  • GT2 = More than two quarters in noncompliance.
  • GE4 = Four or more quarters in noncompliance.
  • GT4 = More than four quarters in noncompliance.
  • GE8 = Eight or more quarters in noncompliance.
  • GT8 = More than eight quarters in noncompliance.
  • GE12 = Twelve or more quarters in noncompliance.
  • GT12 = Twelve or more quarters in noncompliance.
  • 12 = Exactly twelve quarters in noncompliance. Note the seemingly incongruous of GT12 is deliberate.
p_pfead1string

Formal Enforcement Action Date Range Start. Enter a date in MM/DD/YYYY format to set the start of the range for filtering by recent Formal Enforcement Action (FEA) taken against the facility within the last five years.

p_pfead2string

Formal Enforcement Action Date Range End. Enter a date in MM/DD/YYYY format to set the end of the date range for filtering by recent Formal Enforcement Action (FEA) taken against the facility within the last five years.

p_pfeatstring

Formal Enforcement Action (FEA) Code Filter. Enter one or more three-letter FEA codes to restrict results to facilities with these attributes. Use p_fead1 and p_fead2 parameters to further restrict this filter by entering a date range. Provide multiple codes as a comma-delimited list.

p_ss5yrstring

Sanitary Surveys (in past 5 years) flag. Values of visit_reason_code are either "SNSV" or "SNSP" in the past 5 years indicate a Sanitary Survey.

Enter "Y" to select facilities with Sanitary Surveys within the past 5 years.

Enter "N" to select facilities without Sanitary Surveys in the past 5 years.

Enter a number to search for greater for facilities with a quantity than or equal to that value.

p_sdcstring

Significant Deficiency Count (in past 5 years) flag.

Enter "Y" to select facilities with Sanitary Surveys within the past 5 years.

Enter "N" to select facilities without Sanitary Surveys in the past 5 years.

Enter a number to search for facilities with a quantity greater than or equal to that value.

p_sdc_ilsstring
p_ysl'W' | 'N' | 'NV'

Last Facility Inspection [within / not within] Specified Date Range Indicator. The date range is determined by parameters p_idt1 and p_idt2 or by parameter p_ysly.

  • W = within date range
  • N = not within date range
p_ysly'1' | '2' | '3' | '4' | '5'

Number of years (1 to 5) since last facility inspection. A value of 1 means that it has been inspected within the year.

p_ysla'E' | 'S' | 'A'

Facility Last Inspection Code Filter. If left blank, both agencies are included. Enter a value to limit results:

  • E = EPA
  • S = State
p_idt1string

Beginning of date range of most recent facility inspection.

p_idt2string

End of date range of most recent facility inspection.

p_cms_flagstring
querysetnumber

Query Limiter. Enter a value to limit the number of records returned for each query. Value cannot exceed 70,000.

responsesetnumber

Response Set Limiter. Enter a value to limit the number of records per page. Value cannot exceed 1,000.

callbackstring

JSONP Callback. For use with JSONP and GEOJSONP output only. Enter a name of the function in which to wrap the JSON response.

qcolumnsstring

Used to customize service output. A list of comma-separated column IDs of output objects that will be returned in the service query object or download. Use the metadata service endpoint for a complete list of Ids and definitions.

Response

Returns an array of public water systems that meet the specified search criteria.

Example response

{
  "Results": {
    "CVRows": "0",
    "FEARows": "1",
    "INSPRows": "1",
    "IndianCountryRows": "0",
    "InfFEARows": "0",
    "Message": "Success",
    "PageNo": "1",
    "QueryID": "245",
    "QueryRows": "5",
    "SVRows": "0",
    "V3Rows": "2",
    "Version": "v2016-02-02 14:",
    "WaterSystems": [
      {
        "CitiesServed": "CAROLINE",
        "CountiesServed": "ALEXANDRIA",
        "CuAle": "4",
        "CuViol": "2",
        "CurrVioFlag": "0",
        "EPARegion": "04",
        "FIPSCodes": "51033",
        "FeaFlag": "1",
        "Feas": "2",
        "GwSwCode": "GW",
        "HealthFlag": "Y",
        "IeaFlag": "1",
        "Ifea": "3",
        "IndianCountry": "N",
        "Insp5yrFlag": "1",
        "LeadAndCopperViol": "4",
        "MaxScore": "1",
        "MrFlag": "Y",
        "NewVioFlg": "No",
        "OtherFlag": "Y",
        "OwnerDesc": "Local Government",
        "OwnerTypeCode": "P",
        "PWSActivityCode": "A",
        "PWSActivityDesc": "Active",
        "PWSId": "VA0033235",
        "PWSName": "ARBOR CHRISTIAN HOME",
        "PWSTypeCode": "TNCWS",
        "PWSTypeDesc": "Transient non-community system",
        "PbViol": "1",
        "PnFlag": "Y",
        "PopulationServedCount": "34",
        "PrimarySourceCode": "SW",
        "PrimarySourceDesc": "Surface water",
        "QtrsWithSNC": "0",
        "QtrsWithVio": "0",
        "Rc350Viol": "2",
        "RegistryID": "110020837601",
        "RulesVio": "0",
        "RulesVio3yr": "5",
        "SDWA3yrComplQtrsHistory": "____SS__VVUU",
        "SDWAContaminantsInCurViol": "7500=Public Notice",
        "SDWAContaminantsInViol3yr": "2456=Total Haloacetic Acids (HAA5); 7500=Public Notice",
        "SDWDateLastFea": "1/27/2013",
        "SDWDateLastFeaEPA": "4/5/2011",
        "SDWDateLastFeaSt": "2/19/2010",
        "SDWDateLastIea": "6/30/2008",
        "SDWDateLastIeaEPA": "4/11/2013",
        "SDWDateLastIeaSt": "7/17/2010",
        "SDWDateLastVisit": "4/11/2013",
        "SDWDateLastVisitEPA": "4/11/2013",
        "SDWDateLastVisitLocal": "4/11/2013",
        "SDWDateLastVisitState": "4/11/2013",
        "SNC": "In Violation",
        "SNCFlag": "0",
        "Sansurvey5yr": "5",
        "SeriousViolator": "No",
        "SignificantDeficiencyCount": "3",
        "StateCode": "VA",
        "TRIbalFlag": "1",
        "VioFlag": "0",
        "Viofeanot": "1",
        "Viopaccr": "12",
        "Vioremain": "4",
        "Viortcfea": "6",
        "Viortcnofea": "2",
        "ZipCodesServed": "22302"
      }
    ]
  }
}