U.S. EPA Enforcement and Compliance History Online (ECHO) - Safe Drinking Water Act API

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. SDW Rest Services provides multiple service endpoints, each with specific capabilities, to search and retrieve data on public water systems regulated under the Safe Drinking Water Act (SDWA). The returned results reflect data drawn from EPA's Federal Safe Drinking Water Information System (SDWIS) database. \ The get_systems, get_qid, and get_download end points are meant to be used together. \ The recommended use scenario for get_systems, get_qid, and get_downoad is: \ <b>1)</b> Use get_systems 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. <b>2)</b> Use get_qid, with the returned QID, to paginate through arrays of water system results. <b>3)</b> Use get_download, with the returned QID, to generate a Comma Separated Value (CSV) file of water system 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: <a href="https://echo.epa.gov/tools/web-services">Web Services</a>, <a href="https://echo.epa.gov/resources/echo-data/about-the-data">About ECHO's Data</a>, <a href="https://echo.epa.gov/tools/data-downloads">Data Downloads</a>

U.S. EPA Enforcement and Compliance History Online (ECHO) - Safe Drinking Water Act is an open data API from epa.gov. It needs no API key. It is served over HTTPS. Its OpenAPI description documents 8 endpoints.

At a glance

Authentication

No auth

HTTPS

Yes

CORS

Unknown

Category

Open Data

Base URL

https://echodata.epa.gov/echo

Version

2019.10.15

Endpoints

8

OpenAPI

Specification ↗

Spec updated

2021-07-05

Make a first request

Replace the placeholders; the documentation says exactly where credentials go.

curl -X GET "https://echodata.epa.gov/echo/sdw_rest_services.get_download" \
  -H "Accept: application/json"

const response = await fetch("https://echodata.epa.gov/echo/sdw_rest_services.get_download", {
  method: "GET",
  headers: {
    "Accept": "application/json",
  },
});
const data = await response.json();
console.log(data);

import requests

response = requests.request(
    "GET",
    "https://echodata.epa.gov/echo/sdw_rest_services.get_download",
    headers={
    "Accept": "application/json",
    },
    timeout=30,
)
print(response.json())

Endpoints

Questions