Skip to content

U.S. EPA Enforcement and Compliance History Online (ECHO) - Effluent Charting and Reporting API

by epa.gov

No authHTTPSOpen Data
Open documentation ↗

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. EFF Rest Services provides the data for ECHO's Effluent Charts, a set of dynamic charts and tables of permitted effluent limits, releases, and violations over time for Clean Water Act (CWA) wastewater discharge permits issued under the National Pollutant Discharge Elimination System (NPDES). See Effluent Charts Help (https://echo.epa.gov/help/reports/effluent-charts-help) for additional information. \ The are 3 service end points for Effluent Charts: get_summary_chart, get_effluent_chart, and download_effluent_chart. \ <b>1)</b> Use get_summary_chart to retrieve a summary matrix of effluent parameters by effluent outfall and an overall violation status for a provided NPDES Permit and date range. <b>2)</b> Use get_effluent_chart to retrieve detailed Discharge Limit, DMR and NPDES Violation information for a provided NPDES Permit, date range, effluent parameter, or outfall. <b>3)</b> Use download_effluent_chart to generate a Comma Separated Value (CSV) file of the detailed data provided with get_effluent chart, for a provided NPDES Permit, date range, effluent parameter, or outfall. \ 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) - Effluent Charting and Reporting 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
Spec updated
2021-07-05

Make a first request

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

cURL
curl -X GET "https://echodata.epa.gov/echo/eff_rest_services.download_effluent_chart" \
  -H "Accept: application/json"
JavaScript
const response = await fetch("https://echodata.epa.gov/echo/eff_rest_services.download_effluent_chart", {
  method: "GET",
  headers: {
    "Accept": "application/json",
  },
});
const data = await response.json();
console.log(data);
Python
import requests

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

Endpoints

MethodPathWhat it does
GET/eff_rest_services.download_effluent_chartEffluent Charts Download Service
POST/eff_rest_services.download_effluent_chartEffluent Charts Download Service
GET/eff_rest_services.get_effluent_chartDetailed Effluent Chart Service
POST/eff_rest_services.get_effluent_chartDetailed Effluent Chart Service
GET/eff_rest_services.get_summary_chartSummary Effluent Chart Service
POST/eff_rest_services.get_summary_chartSummary Effluent Chart Service
GET/rest_lookups.cwa_parametersECHO CWA Parameter Lookup Service
POST/rest_lookups.cwa_parametersECHO CWA Parameter Lookup Service

Questions

Does the U.S. EPA Enforcement and Compliance History Online (ECHO) - Effluent Charting and Reporting API need an API key?

No. The U.S. EPA Enforcement and Compliance History Online (ECHO) - Effluent Charting and Reporting API can be called without an API key or sign-up, which makes it handy for prototypes and front-end demos.

Does the U.S. EPA Enforcement and Compliance History Online (ECHO) - Effluent Charting and Reporting API support HTTPS?

Yes, the U.S. EPA Enforcement and Compliance History Online (ECHO) - Effluent Charting and Reporting API is served over HTTPS.

How many endpoints does the U.S. EPA Enforcement and Compliance History Online (ECHO) - Effluent Charting and Reporting API have?

Its OpenAPI description lists 8 endpoints in version 2019.10.15. All of them are shown on this page.

What are alternatives to the U.S. EPA Enforcement and Compliance History Online (ECHO) - Effluent Charting and Reporting API?

Other Open Data APIs include Search Services, Wayback API, Wikipedia, Nasdaq Data Link, University of Oslo.

Compare alternatives →

Listed from APIs.guru (CC0).