{ "opencollection": "1.0.0", "info": { "name": "EPA Air Quality System (AQS) Account Type Codes Safe Drinking Water API", "version": "1.0" }, "request": { "auth": { "type": "apikey", "key": "key", "value": "{{key}}", "placement": "query" } }, "items": [ { "info": { "name": "Safe Drinking Water", "type": "folder" }, "items": [ { "info": { "name": "Safe Drinking Water Act (SDWA) Download Data Service", "type": "http" }, "http": { "method": "GET", "url": "https://aqs.epa.gov/data/api/sdw_rest_services.get_download", "params": [ { "name": "output", "value": "string", "type": "query", "description": "Output Format Flag. Enter one of the following keywords:\n- CSV = Facility results formatted as comma delimited file download (default)." }, { "name": "qid", "value": "", "type": "query", "description": "Query ID Selector. Enter the QueryID number from a previously run query." }, { "name": "qcolumns", "value": "", "type": "query", "description": "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." } ] }, "docs": "Based on the QID obtained from a get_systems query, return a comma separated value (CSV) file of the water systems found." }, { "info": { "name": "Safe Drinking Water Act (SDWA) Download Data Service", "type": "http" }, "http": { "method": "POST", "url": "https://aqs.epa.gov/data/api/sdw_rest_services.get_download" }, "docs": "Based on the QID obtained from a get_systems query, return a comma separated value (CSV) file of the water systems found." }, { "info": { "name": "Safe Drinking Water Act (SDWA) Paginated Results Service", "type": "http" }, "http": { "method": "GET", "url": "https://aqs.epa.gov/data/api/sdw_rest_services.get_qid", "params": [ { "name": "output", "value": "string", "type": "query", "description": "Output Format Flag. Enter one of the following keywords:\n- JSON = Data model formatted as Javascript Object Notation (default).\n- JSONP = Data model formatted as Javascript Object Notation with Padding. \n- XML = Data model formatted as Extensible Markup Language." }, { "name": "qid", "value": "", "type": "query", "description": "Query ID Selector. Enter the QueryID number from a previously run query." }, { "name": "pageno", "value": "", "type": "query", "description": "Indicates the number of the page to display. It is used only when the results are paginated." }, { "name": "callback", "value": "", "type": "query", "description": "JSONP Callback. For use with JSONP and GEOJSONP output only. Enter a name of the function in which to wrap the JSON response." }, { "name": "newsort", "value": "", "type": "query", "description": "Output Sort Column. Enter the number of the column on which the data will be sorted. If unpopulated results will sort on the first column." }, { "name": "descending", "value": "", "type": "query", "description": "Output Sort Column Descending Flag. Enter Y to column identified in the newsort parameter descending. Enter N to use ascending sort order. Used only when newsort parameter is populated." }, { "name": "qcolumns", "value": "", "type": "query", "description": "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." } ] }, "docs": "GET_QID is passed with a query ID corresponding to a previously run get_systems query. It then returns a Systems object containing all matching water systems. The main purpose of GET_QID is for large querysets that contain multiple pages (responsesets) of output. GET_QID allows for pagination and for the selection and sorting of columns. " }, { "info": { "name": "Safe Drinking Water Act (SDWA) Paginated Results Service", "type": "http" }, "http": { "method": "POST", "url": "https://aqs.epa.gov/data/api/sdw_rest_services.get_qid" }, "docs": "GET_QID is passed with a query ID corresponding to a previously run get_systems query. It then returns a Systems object containing all matching water systems. The main purpose of GET_QID is for large querysets that contain multiple pages (responsesets) of output. GET_QID allows for pagination and for the selection and sorting of columns. " }, { "info": { "name": "Safe Drinking Water Act (SDWA) Systems Search Service", "type": "http" }, "http": { "method": "GET", "url": "https://aqs.epa.gov/data/api/sdw_rest_services.get_systems", "params": [ { "name": "output", "value": "string", "type": "query", "description": "Output Format Flag. Enter one of the following keywords:\n- JSON = Data model formatted as Javascript Object Notation (default).\n- JSONP = Data model formatted as Javascript Object Notation with Padding. \n- XML = Data model formatted as Extensible Markup Language." }, { "name": "p_fn", "value": "", "type": "query", "description": "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." }, { "name": "p_ct", "value": "", "type": "query", "description": "Facility City Filter. Enter a single case-insensitive city name to filter results." }, { "name": "p_co", "value": "", "type": "query", "description": "Facility County Filter. Provide a single county name in combination with a state value provided via p_st." }, { "name": "p_fips", "value": "", "type": "query", "description": "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." }, { "name": "p_st", "value": "", "type": "query", "description": "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." }, { "name": "p_zip", "value": "", "type": "query", "description": "5-Digit ZIP Code Filter. Provide one or more 5-digit postal zip codes to filter results. May contain multiple comma-separated values." }, { "name": "p_reg", "value": "", "type": "query", "description": "EPA Region Filter. Provide a single value of 01 thru 10 to restrict results to a single EPA region." }, { "name": "p_trb", "value": "", "type": "query", "description": "Tribe name" }, { "name": "p_act", "value": "", "type": "query", "description": "Active Permits/Facilities Flag. Provide Y or N to filter results to facilities with active permits." }, { "name": "p_qiv", "value": "", "type": "query", "description": "Quarters in Noncompliance Limiter. Enter a coded value to limit results to facilities with given quarter of noncompliance.\n- Z = Zero quarters in noncompliance.\n- GEXX = Replacing XX with a numeric value, that number of quarterd or more in noncompliance.\n- GTXX = Replacing XX with a numeric value, more than that number of quarters in noncompliance." }, { "name": "p_ico", "value": "", "type": "query", "description": "Indian Country Flag. Enter a \"Y\" or \"N\" to restrict searches to facilities inside or outside Indian Country." }, { "name": "p_pid", "value": "", "type": "query", "description": "Nine-digit permit IDs. May contain up to 2000 comma-separated values." }, { "name": "p_owop", "value": "", "type": "query", "description": "Owner/Operator code filter. Enter one of the following codes to filter results:\n- F = Federal Government\n- S = State Government\n- L = Local Government\n- M = Public/Private\n- N = Native American\n- P = Private" }, { "name": "p_systyp", "value": "", "type": "query", "description": "Type of public water system:\n- CWS=Community water system\n- NCWS=Non-community water system\n- NTCWS=Non-transient non-community water system\n- TNCWS=Transient non-community water system" }, { "name": "p_swtyp", "value": "", "type": "query", "description": "Source Water Type:\n- SW = Surface water \n- GW= Ground water\n- GU = Ground water under direct influence of (UDI) surface water\n- SWP = Purchased Surface water\n- GWP = Purchased Ground water\n- GUP = Purchased Ground water UDI surface water" }, { "name": "p_popsv", "value": "", "type": "query", "description": "Estimated average daily population served by a system:\n- LE500 = 500 or less\n- IN501_3K = 501-3,300\n- IN3K_10K = 3,301-10,000\n- IN10K_100K = 10,001-100,000\n- IN100K_1M = 100,001-1,000,000\n- GT1M = More than 1,000,000\nMay contain multiple comma-separated values." }, { "name": "p_cntysv", "value": "", "type": "query" }, { "name": "p_cs", "value": "", "type": "query", "description": "Current violations:\n- M = Monitoring and Reporting Violations\n- H = Health-based Violations\n- O = Other Violations\n- P = Public Notice Violations\n- S = Serious Violator\n- N = No Violations\nMay contain multiple comma-separated values." }, { "name": "p_mr", "value": "", "type": "query", "description": "Monitoring and Reporting Violations (failure to conduct regular monitoring of drinking water quality or submit monitoring results in a timely fashion)." }, { "name": "p_health", "value": "", "type": "query", "description": "Violations of health-based drinking water standards (maximum contaminant levels, maximum residual disinfectant levels, or treatment technique rules)." }, { "name": "p_other", "value": "", "type": "query", "description": "Other violations, such as failing to issue annual consumer confidence reports or maintain required records." }, { "name": "p_pn", "value": "", "type": "query", "description": "Public Notice Violations (failure to immediately alert consumers of serious problem with drinking water)." }, { "name": "p_sv", "value": "", "type": "query", "description": "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." }, { "name": "p_qs", "value": "", "type": "query", "description": "Quick Search. Allows entry for city, state, and/or zip code." }, { "name": "p_sfs", "value": "", "type": "query", "description": "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." }, { "name": "p_pswpol", "value": "", "type": "query", "description": "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." }, { "name": "p_pswvio", "value": "", "type": "query", "description": "Used in conjuction with parameters p_pswpol and p_pswparam, indicates whether search should only include pollutants with violations." }, { "name": "p_pbale", "value": "", "type": "query", "description": "Lead Action Level Exceedance. A \"Y\" value will select water systems with at least 1 Lead Action Level Exceedance." }, { "name": "p_cuale", "value": "", "type": "query", "description": "Copper Action Level Exceedance. A \"Y\" value will select water systems with at least 1 Copper Action Level Exceedance." }, { "name": "p_rc350v", "value": "", "type": "query", "description": "Rule code 350 violation. A \"Y\" value will select water systems with at least one rule code 350 violation." }, { "name": "p_pbv", "value": "", "type": "query", "description": "Lead Violations. A \"Y\" value will select water systems with at least 1 Lead Violation." }, { "name": "p_cuv", "value": "", "type": "query", "description": "Copper Violation. A \"Y\" value will select water systems with at least 1 Copper Violation." }, { "name": "p_lcrv", "value": "", "type": "query", "description": "Lead or Copper rule violations. A \"Y\" value will select water systems with at least 1 Lead or Copper Rule Violation." }, { "name": "p_fea", "value": "", "type": "query", "description": "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.\n- W = within date range\n- N = not within date range" }, { "name": "p_feay", "value": "", "type": "query", "description": "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." }, { "name": "p_feaa", "value": "", "type": "query", "description": "Agency associated with Formal Enforcement Actions:\n- E = EPA\n- S = State\n- A = All" }, { "name": "p_iea", "value": "", "type": "query", "description": "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.\n- W = within date range\n- N = not within date range" }, { "name": "p_ieay", "value": "", "type": "query", "description": "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." }, { "name": "p_ieaa", "value": "", "type": "query", "description": "Agency associated with Informal Enforcement Actions. If left blank, both agencies are included.\n- E = EPA\n- S = State" }, { "name": "p_qis", "value": "", "type": "query", "description": "Significant Quarters in Noncompliance Limiter. Enter one of the following codes to limit results to facilities having given quarters of noncompliance.\n- Z = Zero quarters in noncompliance.\n- GE1 = One or more quarters in noncompliance.\n- GT1 = More than one quarters in noncompliance.\n- GE2 = Two or more quarters in noncompliance.\n- GT2 = More than two quarters in noncompliance.\n- GE4 = Four or more quarters in noncompliance.\n- GT4 = More than four quarters in noncompliance.\n- GE8 = Eight or more quarters in noncompliance.\n- GT8 = More than eight quarters in noncompliance.\n- GE12 = Twelve or more quarters in noncompliance.\n- GT12 = Twelve or more quarters in noncompliance.\n- 12 = Exactly twelve quarters in noncompliance.\nNote the seemingly incongruous of GT12 is deliberate." }, { "name": "p_pfead1", "value": "", "type": "query", "description": "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." }, { "name": "p_pfead2", "value": "", "type": "query", "description": "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." }, { "name": "p_pfeat", "value": "", "type": "query", "description": "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." }, { "name": "p_ss5yr", "value": "", "type": "query", "description": "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. \n\nEnter \"Y\" to select facilities with Sanitary Surveys within the past 5 years. \n\nEnter \"N\" to select facilities without Sanitary Surveys in the past 5 years.\n\nEnter a number to search for greater for facilities with a quantity than or equal to that value.\n\n\n" }, { "name": "p_sdc", "value": "", "type": "query", "description": "Significant Deficiency Count (in past 5 years) flag. \n\nEnter \"Y\" to select facilities with Sanitary Surveys within the past 5 years. \n\nEnter \"N\" to select facilities without Sanitary Surveys in the past 5 years.\n\nEnter a number to search for facilities with a quantity greater than or equal to that value." }, { "name": "p_sdc_ils", "value": "", "type": "query" }, { "name": "p_ysl", "value": "", "type": "query", "description": "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.\n- W = within date range\n- N = not within date range" }, { "name": "p_ysly", "value": "", "type": "query", "description": "Number of years (1 to 5) since last facility inspection. A value of 1 means that it has been inspected within the year." }, { "name": "p_ysla", "value": "", "type": "query", "description": "Facility Last Inspection Code Filter. If left blank, both agencies are included. Enter a value to limit results:\n- E = EPA\n- S = State" }, { "name": "p_idt1", "value": "", "type": "query", "description": "Beginning of date range of most recent facility inspection." }, { "name": "p_idt2", "value": "", "type": "query", "description": "End of date range of most recent facility inspection." }, { "name": "p_cms_flag", "value": "", "type": "query" }, { "name": "queryset", "value": "", "type": "query", "description": "Query Limiter. Enter a value to limit the number of records returned for each query. Value cannot exceed 70,000." }, { "name": "responseset", "value": "", "type": "query", "description": "Response Set Limiter. Enter a value to limit the number of records per page. Value cannot exceed 1,000." }, { "name": "callback", "value": "", "type": "query", "description": "JSONP Callback. For use with JSONP and GEOJSONP output only. Enter a name of the function in which to wrap the JSON response." }, { "name": "qcolumns", "value": "", "type": "query", "description": "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." } ] }, "docs": "Returns an array of public water systems that meet the specified search criteria." }, { "info": { "name": "Safe Drinking Water Act (SDWA) Systems Search Service", "type": "http" }, "http": { "method": "POST", "url": "https://aqs.epa.gov/data/api/sdw_rest_services.get_systems" }, "docs": "Returns an array of public water systems that meet the specified search criteria." } ] } ], "bundled": true }