Epa

U.S. EPA Enforcement and Compliance History Online (ECHO) - Clean Water Act (CW…

Enforcement and Compliance History Online (ECHO) is a tool developed and maintained by EPA's Office of Enforcement and Compliance Assurance for public use.…

Government & public#openapi#open-data

Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.

Overview

Enforcement and Compliance History Online (ECHO) is a tool developed and maintained by EPA's Office of Enforcement and Compliance Assurance for public use. ECHO provides integrated compliance and enforcement information for over 1 million regulated facilities nationwide.
CWA Rest Services provides multiple service endpoints, each with specific capabilities, to search and retrieve data on facilities regulated under the Clean Water Act (CWA) and managed under the National Pollutant Discharge Elimination System (NPDES) program. The returned results reflect data drawn from EPA's ICIS-NPDES database.
\
The get_facilities, get_map, get_qid, and get_download end points are meant to be used together, while the enhanced get_facility_info end point is self contained.
The get_facility_info end point returns either an array of state, county or zip clusters with summary statistics per cluster or an array of facilities.
\
The recommended use scenario for get_facilities, get_qid, get_map, and get_downoad is:
\
1) Use get_facilities to validate passed query parameters, obtain summary statistics and to obtain a query_id (QID). QIDs are time sensitive and will be valid for approximately 30 minutes.
2) Use get_qid, with the returned QID, to paginate through arrays of facility results.
3) Use get_map, with the returned QID, to zoom in/out and pan on the clustered and individual facility coordinates that meet the QID query criteria.
4) Use get_download, with the returned QID, to generate a Comma Separated Value (CSV) file of facility information that meets the QID query criteria.
\
\
Use the qcolumns parameter to customize your search results. Use the Metadata service endpoint for a list of available output objects, their Column Ids, and their definitions to help you build your customized output.
\
Additional ECHO Resources: Web Services , About ECHO's Data , Data Downloads

Endpoints 36

Facility Information

  • GETClean Water Act (CWA) Download Data Service/cwa_rest_services.get_download?output=string&qid=string&qcolumns=string&p_pretty_print=0.0Based on the QID obtained from a get_facilities or get_facility_info query, return a comma separated value (CSV) file of the facilities found.
  • POSTClean Water Act (CWA) Download Data Service/cwa_rest_services.get_downloadBased on the QID obtained from a get_facilities or get_facility_info query, return a comma separated value (CSV) file of the facilities found.
  • GETClean Water Act (CWA) Facility Search Service/cwa_rest_services.get_facilities?output=JSONP&p_fn=string&p_sa=string&p_sa1=string&p_ct=string&p_co=string&p_fips=string&p_st=string&p_zip=string&p_frs=string&p_reg=01&p_sic=string&p_ncs=string&p_pen=string&p_c1lat=0.0&p_c1lon=0.0&p_c2lat=0.0&p_c2lon=0.0&p_usmex=Y&p_sic2=string&p_sic4=string&p_fa=string&p_ff=Y&p_act=string&p_maj=Y&p_mact=string&p_fea=W&p_feay=1&p_feaa=A&p_iea=W&p_ieay=1&p_ieaa=E&p_qiv=0&p_iv=string&p_impw=Y&p_imp_cau_grp=ALGAL GROWTH&p_imp_pol=Y&p_trep=CURR&p_pm=NONE&p_pd=NONE&p_ico=Y&p_huc=string&p_pid=string&p_med=A&p_ysl=W&p_ysly=1&p_ysla=E&p_qs=string&p_sfs=string&p_tribeid=0.0&p_tribename=string&p_tribedist=0.0&p_pstat=string&p_ptype=string&p_pcomp=string&p_plimits=Y&p_pcss=ALL&p_pexp=EXP&p_owop=FEDERAL&p_ipfti=string&p_agoo=AND&p_idt1=string&p_idt2=string&p_pityp=string&p_pfead1=string&p_pfead2=string&p_pfeat=string&p_pccs=string&p_pexcd=0&p_psncq=GT1&p_pctrack=Off&p_dwd=0&p_pt=0&p_pdwdist=N&p_pswdpc=string&p_pswdmp=1&p_pswpol=string&p_pswcas=string&p_pswparam=string&p_pswvio=Y&p_wbd=string&p_radwbd=string&p_frswbd=string&p_fntype=ALL&p_pidall=Y&p_months_last_dmr=0.0&p_last_dmr_within=W&p_indsw=Y&p_msgp_ptype=NOI&p_mon_type=BENCHG2&p_iagency=string&p_permitting_agency=string&p_isws=string&p_iswss=string&p_iswssID=string&p_ds1=string&p_ds2=string&p_da1=string&p_da2=string&p_MS4=Y&p_ooFN=string&p_ooFNtype=ALL&p_ooSA=string&p_ooSA1=string&p_ooCt=string&p_ooSt=string&p_ooZip=string&p_fac_ico=Y&p_icoo=string&p_fac_icos=string&p_ejscreen=string&p_alrexceed=0.0&p_limit_addr=Y&p_lat=0.0&p_long=0.0&p_radius=0.0&p_ejscreen_over80cnt=1&p_bio_flag=string&p_bio_fac_type=string&p_bio_trtmnt_procs=string&p_bio_analy_method_catgry=string&p_bio_total_volume_amt=string&p_bio_mgmt_prctce_type=string&p_bio_mgmt_prctce_stype=string&p_bio_mgmt_prctce_handler=string&p_bio_mgmt_container=string&p_bio_mgmt_pathogen=string&p_bio_mgmt_pathred=string&p_bio_mgmt_vector=string&p_bio_mgmt_def_category=string&p_bio_mgmt_deficiencies=0.0&p_bio_vio_code=string&p_bio_current_vio=Y&p_bio_qtrs_in_vio=0.0&p_bio_rpt_year=string&p_bio_vio_last_year=Y&p_msgp_rpt_year=string&p_vio_last_year=Y&queryset=0.0&responseset=0.0&tablelist=Y&maplist=Y&summarylist=Y&callback=string&qcolumns=string&p_e90_count=0.0&p_e90_years=0.0&p_psc=stringValidates query search parameters and returns query identifier. Use the responseset parameter to set the page size
  • POSTClean Water Act (CWA) Facility Search Service/cwa_rest_services.get_facilitiesValidates query search parameters and returns query identifier. Use the responseset parameter to set the page size
  • GETClean Water Act (CWA) Facility Enhanced Search Service/cwa_rest_services.get_facility_info?output=string&p_fn=string&p_sa=string&p_sa1=string&p_ct=string&p_co=string&p_fips=string&p_st=string&p_zip=string&p_frs=string&p_reg=01&p_sic=string&p_ncs=string&p_pen=string&xmin=0.0&ymin=0.0&xmax=0.0&ymax=0.0&p_usmex=Y&p_sic2=string&p_sic4=string&p_fa=string&p_ff=Y&p_act=string&p_maj=Y&p_mact=string&p_fea=W&p_feay=1&p_feaa=A&p_iea=W&p_ieay=1&p_ieaa=E&p_qiv=0&p_iv=string&p_impw=Y&p_imp_pol=Y&p_imp_cau_grp=ALGAL GROWTH&p_trep=CURR&p_pm=NONE&p_pd=NONE&p_ico=Y&p_huc=string&p_pid=string&p_med=A&p_ysl=W&p_ysly=1&p_ysla=E&p_qs=string&p_sfs=string&p_tribeid=0.0&p_tribename=string&p_tribedist=0.0&p_pstat=string&p_ptype=string&p_pcomp=string&p_plimits=Y&p_pcss=ALL&p_pexp=EXP&p_owop=FEDERAL&p_ipfti=string&p_agoo=AND&p_idt1=string&p_idt2=string&p_pityp=string&p_pfead1=string&p_pfead2=string&p_pfeat=string&p_pccs=string&p_pexcd=0&p_psncq=GT1&p_pctrack=Off&p_dwd=0&p_pt=0&p_pdwdist=N&p_pswdpc=string&p_pswdmp=1&p_pswpol=string&p_pswcas=string&p_pswparam=string&p_pswvio=Y&p_wbd=string&p_radwbd=string&p_frswbd=string&p_fntype=ALL&p_pidall=Y&p_months_last_dmr=0.0&p_last_dmr_within=W&p_indsw=Y&p_msgp_ptype=NOI&p_mon_type=BENCHG2&p_iagency=string&p_permitting_agency=string&p_isws=string&p_iswss=string&p_iswssID=string&p_ds1=string&p_ds2=string&p_da1=string&p_da2=string&p_MS4=Y&p_ooFN=string&p_ooFNtype=ALL&p_ooSA=string&p_ooSA1=string&p_ooCt=string&p_ooSt=string&p_ooZip=string&p_fac_ico=Y&p_icoo=string&p_fac_icos=string&p_ejscreen=string&p_alrexceed=0.0&p_limit_addr=Y&p_lat=0.0&p_long=0.0&p_radius=0.0&p_ejscreen_over80cnt=1&p_bio_flag=string&p_bio_fac_type=string&p_bio_trtmnt_procs=string&p_bio_analy_method_catgry=string&p_bio_total_volume_amt=string&p_bio_mgmt_prctce_type=string&p_bio_mgmt_prctce_stype=string&p_bio_mgmt_prctce_handler=string&p_bio_mgmt_container=string&p_bio_mgmt_pathogen=string&p_bio_mgmt_pathred=string&p_bio_mgmt_vector=string&p_bio_mgmt_def_category=string&p_bio_mgmt_deficiencies=0.0&p_bio_vio_code=string&p_bio_current_vio=Y&p_bio_qtrs_in_vio=0.0&p_bio_rpt_year=string&p_bio_vio_last_year=Y&p_msgp_rpt_year=string&p_vio_last_year=Y&responseset=0.0&callback=string&qcolumns=string&p_pretty_print=0.0&p_e90_count=0.0&p_e90_years=0.0&p_psc=stringReturns either an array of Facilities or an array of Clusters that meet the specified search criteria.
  • POSTClean Water Act (CWA) Facility Enhanced Search Service/cwa_rest_services.get_facility_infoReturns either an array of Facilities or an array of Clusters that meet the specified search criteria.
  • GETClean Water Act (CWA) GeoJSON Service/cwa_rest_services.get_geojson?output=string&qid=string&callback=string&newsort=0.0&descending=Y&qcolumns=string&p_pretty_print=0.0Based on the QID obtained from a get_facilities or get_facility_info query, return GeoJSON of the facilities found.
  • POSTClean Water Act (CWA) GeoJSON Service/cwa_rest_services.get_geojsonBased on the QID obtained from a get_facilities or get_facility_info query, return GeoJSON of the facilities found.
  • GETClean Water Act (CWA) Info Clusters Service/cwa_rest_services.get_info_clusters?output=string&p_qid=string&p_pretty_print=0.0Based on the QID obtained from a clustered get_facility_info query, download cluster facility information as either a CSV or GEOJSON file.
  • POSTClean Water Act (CWA) Info Clusters Service/cwa_rest_services.get_info_clustersBased on the QID obtained from a clustered get_facility_info query, download cluster facility information as either a CSV or GEOJSON file.
  • GETClean Water Act (CWA) Map Service/cwa_rest_services.get_map?output=JSONP&qid=string&callback=string&tablelist=Y&c1_lat=0.0&c1_long=0.0&c2_lat=0.0&c2_long=0.0&p_id=stringThe purpose of the GET_MAP service is to display facility coordinates and facility clusters related to a get_facilities facility query. Currently, the maximum…
  • POSTClean Water Act (CWA) Map Service/cwa_rest_services.get_mapThe purpose of the GET_MAP service is to display facility coordinates and facility clusters related to a get_facilities facility query. Currently, the maximum…
  • GETClean Water Act (CWA) Paginated Results Service/cwa_rest_services.get_qid?output=JSONP&qid=string&pageno=1&callback=string&newsort=0.0&descending=Y&qcolumns=stringGET_QID is passed with a query ID corresponding to a previously run get_facilities query. It then returns a Facility object containing all matching…
  • POSTClean Water Act (CWA) Paginated Results Service/cwa_rest_services.get_qidGET_QID is passed with a query ID corresponding to a previously run get_facilities query. It then returns a Facility object containing all matching…

Metadata

  • GETClean Water Act (CWA) Metadata Service/cwa_rest_services.metadata?output=JSONP&callback=stringReturns the JSON Object Name and ColumnId for usage with the qcolumns parameter for get_qid, get_facility_info and other service endpoints.
  • POSTClean Water Act (CWA) Metadata Service/cwa_rest_services.metadataReturns the JSON Object Name and ColumnId for usage with the qcolumns parameter for get_qid, get_facility_info and other service endpoints.

Lookups

  • GETECHO BP Tribes Lookup Service/rest_lookups.bp_tribes?output=JSONP&callback=string&search_term=string&search_code=stringReturns the EPA Standard Indian Tribes and Native Alaskan Villages tribal_id and tribe_name.
  • POSTECHO BP Tribes Lookup Service/rest_lookups.bp_tribesReturns the EPA Standard Indian Tribes and Native Alaskan Villages tribal_id and tribe_name.
  • GETECHO CWA Parameter Lookup Service/rest_lookups.cwa_parameters?output=JSONP&callback=string&search_term=string&search_code=stringLook up Clean Water Act parameter codes and descriptions in the Integrated Compliance Information System - National Pollutant Discharge Elimination System…
  • POSTECHO CWA Parameter Lookup Service/rest_lookups.cwa_parametersLook up Clean Water Act parameter codes and descriptions in the Integrated Compliance Information System - National Pollutant Discharge Elimination System…
  • GETECHO CWA Pollutants Lookup Service/rest_lookups.cwa_pollutants?output=JSONP&callback=string&search_term=string&search_code=stringLook up Clean Water Act pollutants by name
  • POSTECHO CWA Pollutants Lookup Service/rest_lookups.cwa_pollutantsLook up Clean Water Act pollutants by name
  • GETECHO Federal Agency Lookup Service/rest_lookups.federal_agencies?output=JSONP&callback=string&search_term=string&search_code=stringLook up Federal Agency Code
  • POSTECHO Federal Agency Lookup Service/rest_lookups.federal_agenciesLook up Federal Agency Code
  • GETECHO ICIS NPDES Inspection Types Lookup Service/rest_lookups.icis_inspection_types?output=JSONP&callback=string&search_term=string&search_code=stringReturns the ICIS NPDES Compliance Monitoring Type Code and Description.
  • POSTECHO ICIS NPDES Inspection Types Lookup Service/rest_lookups.icis_inspection_typesReturns the ICIS NPDES Compliance Monitoring Type Code and Description.
  • GETECHO ICIS NPDES Law Sections Lookup Service/rest_lookups.icis_law_sections?output=JSONP&callback=string&statute_code=string&status_flag=string&search_term=string&search_code=string&sort_order=0.0Returns the ICIS NPDES Law Section Descriptions.
  • POSTECHO ICIS NPDES Law Sections Lookup Service/rest_lookups.icis_law_sectionsReturns the ICIS NPDES Law Section Descriptions.
  • GETECHO NAICS Codes Lookup Service/rest_lookups.naics_codes?output=JSONP&callback=string&search_term=string&search_code=string
  • POSTECHO NAICS Codes Lookup Service/rest_lookups.naics_codes
  • GETECHO NPDES Parameters Lookup Service/rest_lookups.npdes_parameters?output=JSONP&callback=string&search_term=stringICIS Limit Parameter Code and Name lookup based on the supply of a partial parameter name. (NPDES = National Pollutant Discharge Elimination System)
  • POSTECHO NPDES Parameters Lookup Service/rest_lookups.npdes_parametersICIS Limit Parameter Code and Name lookup based on the supply of a partial parameter name. (NPDES = National Pollutant Discharge Elimination System)
  • GETECHO WBD Code Lookup Service/rest_lookups.wbd_code_lu?output=JSONP&callback=string&wbd_code=string&wbd_level=stringUSGS Watershed Boundary Dataset (WBD) Name lookup based on a supplied WBD Code and Watershed Level
  • POSTECHO WBD Code Lookup Service/rest_lookups.wbd_code_luUSGS Watershed Boundary Dataset (WBD) Name lookup based on a supplied WBD Code and Watershed Level
  • GETECHO WBD Name Lookup Service/rest_lookups.wbd_name_lu?output=JSONP&callback=string&wbd_name=string&wbd_level=stringUSGS Watershed Boundary Dataset (WBD) Code lookup based on a supplied WBD Name and Watershed Level
  • POSTECHO WBD Name Lookup Service/rest_lookups.wbd_name_luUSGS Watershed Boundary Dataset (WBD) Code lookup based on a supplied WBD Name and Watershed Level

API details

Base URL
https://echodata.epa.gov/echo
Authentication
None declared in the description
Operations
36 operations on 18 pathsGET 18POST 18
Main resources
Lookups 20Facility Information 14Metadata 2
Response formats
application/json application/xml
Description format
Swagger 2.0, API version 2019.10.15
Listed from
APIs.guru OpenAPI Directory (CC0-1.0)
Source updated

How to test the U.S. EPA Enforcement and Compliance History Online (ECHO) - Clean Water Act (CW… in Swastik Codes

  1. Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
  2. Fork it into your workspaceChoose a workspace. You get your own copy of the U.S. EPA Enforcement and Compliance History Online (ECHO) - Clean Water Act (CW… collection, without the publisher's secrets.
  3. Add your credentialsOpen the collection's variables or an environment and enter your API key or token, if the API needs one.
  4. Send a requestPick an endpoint, for example “Clean Water Act (CWA) Download Data Service” (GET /cwa_rest_services.get_download?output=string&qid=string&qcolumns=string&p_pretty_print=0.0), and press Send. Check the response, add tests and run the whole collection with the runner.

Frequently asked questions

What is the U.S. EPA Enforcement and Compliance History Online (ECHO) - Clean Water Act (CW…?

Enforcement and Compliance History Online (ECHO) is a tool developed and maintained by EPA's Office of Enforcement and Compliance Assurance for public use.… It is listed under Government & public and has 36 endpoints.

Who publishes the U.S. EPA Enforcement and Compliance History Online (ECHO) - Clean Water Act (CW…?

It is listed from Epa's public API description (an OpenAPI document), not published by Epa on Swastik Codes. Anyone who controls epa.gov can claim the profile by adding a DNS TXT record.

What is the base URL of the U.S. EPA Enforcement and Compliance History Online (ECHO) - Clean Water Act (CW…?

Requests go to https://echodata.epa.gov/echo. Endpoint paths are added to this base URL.

How do I authenticate with the U.S. EPA Enforcement and Compliance History Online (ECHO) - Clean Water Act (CW…?

Its OpenAPI description does not declare an authentication scheme. Some endpoints may be open; check the provider's documentation before relying on that.

How many endpoints does the U.S. EPA Enforcement and Compliance History Online (ECHO) - Clean Water Act (CW… have?

36 operations on 18 paths (18 GET, 18 POST). The largest groups are Lookups, Facility Information, Metadata.

Is forking the U.S. EPA Enforcement and Compliance History Online (ECHO) - Clean Water Act (CW… free?

Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.

Suggest an API

Tell us which public API is missing. We check it, then add it here with its endpoints when it has an OpenAPI (Swagger) description.