Epa

U.S. EPA Enforcement and Compliance History Online (ECHO) - Clean Air Act

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.

Air Rest Services provides multiple service endpoints, each with specific capabilities, to search and retrieve data on facilities regulated under the Clean Air Act (CAA). The returned results reflect data drawn from EPA's ICIS-Air 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 16

Facilities

  • GETClean Air Act Download Data Service/air_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 sepated vaule (CSV) file of the facilities found.
  • POSTClean Air Act Download Data Service/air_rest_services.get_downloadBased on the QID obtained from a get_facilities or get_facility_info query, return a comma sepated vaule (CSV) file of the facilities found.
  • GETClean Air Act Facility Search/air_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_lcon=string&p_frs=string&p_reg=01&p_sic=string&p_ncs=string&p_qnc=0.0&p_pen=string&p_opst=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_act=Y&p_maj=Y&p_mact=string&p_nsps=string&p_nspsm=string&p_prog=string&p_fea=W&p_feay=1&p_feaa=A&p_iea=W&p_ieay=1&p_ieaa=E&p_qiv=0&p_naa=string&p_impw=Y&p_trep=CURR&p_tri_cat=TOTAL&p_tri_amt=0&p_tri_any_amt=0.0&p_tri_pol=string&p_ghg_cat=ALL&p_ghg_amt=None&p_ghg_any_amt=0.0&p_ghg_yr=string&p_nei_pol=string&p_nei_amt=None&p_nei_any_amt=0.0&p_nei_yr=string&p_nei_cat=string&p_pm=NONE&p_pd=NONE&p_ico=Y&p_huc=string&p_wbd=string&p_pid=string&p_med=M&p_ysl=W&p_ysly=1&p_ysla=E&p_stsl=W&p_stsly=1&p_stsla=A&p_stres=string&p_sttyp=string&p_qs=string&p_sfs=string&p_tribeid=0.0&p_tribename=string&p_tribedist=0.0&p_owop=string&p_agoo=AND&p_idt1=string&p_idt2=string&p_stdt1=string&p_stdt2=string&p_pityp=string&p_cifdi=Any&p_pfead1=string&p_pfead2=string&p_pfeat=string&p_psncq=GT1&p_pctrack=Off&p_swpa=source water&p_des=string&p_fntype=ALL&p_hpvmth=string&p_recvio=string&p_pollvio=string&p_ar=string&p_tri_yr=string&p_pidall=Y&p_fac_ico=Y&p_icoo=string&p_fac_icos=string&p_ejscreen=string&p_limit_addr=Y&p_lat=0.0&p_long=0.0&p_radius=0.0&p_decouple=Y&p_ejscreen_over80cnt=1&queryset=0.0&responseset=0.0&tablelist=Y&maplist=Y&summarylist=Y&callback=string&qcolumns=stringValidates query search parameters and returns query identifier. Use the responseset parameter to set the page size
  • POSTClean Air Act Facility Search/air_rest_services.get_facilitiesValidates query search parameters and returns query identifier. Use the responseset parameter to set the page size
  • GETClean Air Act Facility Enhanced Search/air_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_lcon=string&p_frs=string&p_reg=01&p_sic=string&p_ncs=string&p_qnc=0.0&p_pen=string&p_opst=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_act=Y&p_maj=Y&p_mact=string&p_nsps=string&p_nspsm=string&p_prog=string&p_fea=W&p_feay=1&p_feaa=A&p_iea=W&p_ieay=1&p_ieaa=E&p_qiv=0&p_naa=string&p_impw=Y&p_trep=CURR&p_tri_cat=TOTAL&p_tri_amt=0&p_tri_any_amt=0.0&p_tri_pol=string&p_ghg_cat=ALL&p_ghg_amt=None&p_ghg_any_amt=0.0&p_ghg_yr=string&p_nei_pol=string&p_nei_amt=None&p_nei_any_amt=0.0&p_nei_yr=string&p_nei_cat=string&p_pm=NONE&p_pd=NONE&p_ico=Y&p_huc=string&p_wbd=string&p_pid=string&p_med=M&p_ysl=W&p_ysly=1&p_ysla=E&p_stsl=W&p_stsly=1&p_stsla=A&p_stres=string&p_sttyp=string&p_qs=string&p_sfs=string&p_tribeid=0.0&p_tribename=string&p_tribedist=0.0&p_owop=string&p_agoo=AND&p_idt1=string&p_idt2=string&p_stdt1=string&p_stdt2=string&p_pityp=string&p_cifdi=Any&p_pfead1=string&p_pfead2=string&p_pfeat=string&p_psncq=GT1&p_pctrack=Off&p_swpa=source water&p_des=string&p_fntype=ALL&p_hpvmth=string&p_recvio=string&p_pollvio=string&p_ar=string&p_tri_yr=string&p_pidall=Y&p_fac_ico=Y&p_icoo=string&p_fac_icos=string&p_ejscreen=string&p_limit_addr=Y&p_lat=0.0&p_long=0.0&p_radius=0.0&p_decouple=Y&p_ejscreen_over80cnt=1&queryset=0.0&responseset=0.0&summarylist=Y&callback=string&qcolumns=string&p_pretty_print=0.0Returns either an array of Facilities or an array of Clusters that meet the specified search criteria.
  • POSTClean Air Act Facility Enhanced Search/air_rest_services.get_facility_infoReturns either an array of Facilities or an array of Clusters that meet the specified search criteria.
  • GETClean Air Act GeoJSON Service/air_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 Air Act GeoJSON Service/air_rest_services.get_geojsonBased on the QID obtained from a get_facilities or get_facility_info query, return GeoJSON of the facilities found.
  • GETClean Air Act Info Clusters Service/air_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 Air Act Info Clusters Service/air_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 Air Act Map Service/air_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 Air Act Map Service/air_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 Air Act Search by Query ID/air_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 Air Act Search by Query ID/air_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 Air Act Metadata Service/air_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 Air Act Metadata Service/air_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.

API details

Base URL
https://echodata.epa.gov/echo
Authentication
None declared in the description
Operations
16 operations on 8 pathsGET 8POST 8
Main resources
Facilities 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 Air Act 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 Air Act 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 Air Act Download Data Service” (GET /air_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 Air Act?

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 16 endpoints.

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

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 Air Act?

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 Air Act?

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 Air Act have?

16 operations on 8 paths (8 GET, 8 POST). The largest groups are Facilities, Metadata.

Is forking the U.S. EPA Enforcement and Compliance History Online (ECHO) - Clean Air Act 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.