Epa

U.S. EPA Enforcement and Compliance History Online (ECHO) - Enforcement Case Se…

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.
CASE Rest Services provide multiple service endpoints, each with specific capabilities, to search and retrieve data on civil cases entered into the
Integrated Compliance Information System (ICIS) and criminal cases entered into the Summary of Criminal Prosecutions database.
See Enforcement Case Search Help (https://echo.epa.gov/help/enforcement-case-search-help) for additional information on searching civil and criminal cases.
\
The get_cases, get_map, get_qid, and get_download end points are meant to be used together, while the enhanced get_case_info end point is self contained..
The recommended use scenario for get_cases, get_qid, get_map, and get_downoad is:
\
1) Use get_cases 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 case results.
3) Use get_map, with the returned QID, to zoom in/out and pan on the clustered and individual facility coordinates, related to the returned cases, 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.
\
In addition to the service endpoints listed above there are two detailed case report services, one for civil cases (get_case_report) and one for criminal cases (get_crcase_report).
See the Civil Enforcement Case Report Help (https://echo.epa.gov/help/reports/enforcement-case-report-help) and the Criminal Case Report Help (https://echo.epa.gov/help/reports/criminal-case-report-help) for additional information
on then data returned from these two services.
\
Additional ECHO Resources: Web Services , About ECHO's Data , Data Downloads

Endpoints 22

Case Enforcement

  • GETEnforcement Case Search (new version)/case_rest_services.get_case_info?output=JSONP&p_case_category=string&p_case_status=string&p_milestone=string&p_from_date=string&p_to_date=string&p_milestone_fy=string&p_name=string&p_name_type=string&p_case_number=string&p_docket_number=string&p_court_docket_number=string&p_activity_number=string&p_case_lead=E&p_case_sens_flg=string&p_region=01&p_state=string&p_district=string&p_sic=string&p_sic_ao_naics=AND&p_sic_primary_flg=Y&p_sic_frs_flg=Y&p_naics=string&p_naics_primary_flg=Y&p_naics_frs_flg=Y&p_enf_type=string&p_law=string&p_section=string&p_cp_citation=string&p_rank_order=1&p_enf_program=string&p_violation=string&p_priority_area=string&p_priority_area_desc=string&p_tribal=Y&p_oeca_core=Y&p_multimedia=Y&p_fed_case=Y&p_activity_contact=string&p_role=string&p_fed_penalty=ANY&p_total_fed_penalty=string&p_cost_recovery=string&p_total_cost_recovery=string&p_complying_actions=string&p_comp_act_val=ANY&p_total_comp_act_val=string&p_sep_cats=string&p_sep_val=ANY&p_total_sep_val=string&p_lodged_date=string&p_entered_date=string&p_facility_id=string&p_fac_city=string&p_fac_zip=string&p_fac_county=string&p_case_summary=string&p_case_summary_type=ALL&p_usmex=Y&p_c1lat=0.0&p_c1lon=0.0&p_c2lat=0.0&p_c2lon=0.0&p_voluntary=string&p_fed_indicator=string&p_fntype=ALL&p_civil_criminal_indicator=CI&queryset=0.0&responseset=0.0&mapset=1400&callback=string&qcolumns=string&p_pretty_print=0.0&p_ocmap_fy=string&p_qs=string&p_has_map=stringThe get_case_info service end point searches for civil enforcement and criminal cases based on the provided selection criteria and returns either individual…
  • POSTEnforcement Case Search (new version)/case_rest_services.get_case_infoThe get_case_info service end point searches for civil enforcement and criminal cases based on the provided selection criteria and returns either individual…
  • GETEnforcement Case Summary Report Search/case_rest_services.get_case_report?p_id=string&output=JSONP&callback=stringThe get_case_report service endpoint returns a complex object of civil enforcement case details based on the provided case id.
  • POSTEnforcement Case Summary Report Search/case_rest_services.get_case_reportThe get_case_report service endpoint returns a complex object of civil enforcement case details based on the provided case id.
  • GETEnforcement Case Search/case_rest_services.get_cases?output=JSONP&p_case_category=string&p_case_status=string&p_violation=string&p_milestone=string&p_from_date=string&p_to_date=string&p_milestone_fy=string&p_name=string&p_name_type=string&p_case_number=string&p_docket_number=string&p_court_docket_number=string&p_activity_number=string&p_case_lead=E&p_case_sens_flg=string&p_region=01&p_state=string&p_district=string&p_sic=string&p_sic_ao_naics=AND&p_sic_primary_flg=Y&p_sic_frs_flg=Y&p_naics=string&p_naics_primary_flg=Y&p_naics_frs_flg=Y&p_enf_type=string&p_law=string&p_section=string&p_cp_citation=string&p_rank_order=1&p_enf_program=string&p_priority_area=string&p_priority_area_desc=string&p_tribal=Y&p_oeca_core=Y&p_multimedia=Y&p_fed_case=Y&p_activity_contact=string&p_role=string&p_fed_penalty=ANY&p_total_fed_penalty=string&p_cost_recovery=string&p_total_cost_recovery=string&p_complying_actions=string&p_comp_act_val=ANY&p_total_comp_act_val=string&p_sep_cats=string&p_sep_val=ANY&p_total_sep_val=string&p_lodged_date=string&p_entered_date=string&p_facility_id=string&p_fac_city=string&p_fac_zip=string&p_fac_county=string&p_case_summary=string&p_case_summary_type=ALL&p_usmex=Y&p_c1lat=0.0&p_c1lon=0.0&p_c2lat=0.0&p_c2lon=0.0&p_voluntary=string&p_fed_indicator=string&p_fntype=ALL&p_civil_criminal_indicator=CI&queryset=0.0&responseset=0.0&maplist=Y&tablelist=Y&callback=string&qcolumns=string&p_ocmap_fy=string&p_qs=string&p_has_map=stringThe get_cases service end point searches for civil enforcement and criminal cases based on the provided selection criteria.
  • POSTEnforcement Case Search/case_rest_services.get_casesThe get_cases service end point searches for civil enforcement and criminal cases based on the provided selection criteria.
  • GETPlaceholder/case_rest_services.get_cases_from_facility?p_id=string&output=JSONP&callback=string
  • POSTPlaceholder/case_rest_services.get_cases_from_facility?p_id=string&output=JSONP&callback=string
  • GETEnforcement Criminal Case Summary Report Search/case_rest_services.get_crcase_report?p_id=string&output=JSONP&callback=string&mapset=1400The get_crcase_report service end point returns a complex object of criminal case detials based on the provided criminal case id.
  • POSTEnforcement Criminal Case Summary Report Search/case_rest_services.get_crcase_reportThe get_crcase_report service end point returns a complex object of criminal case detials based on the provided criminal case id.
  • GETEnforcement Case Download Data Service/case_rest_services.get_download?output=string&qid=string&qcolumns=stringBased on the QID obtained from a get_cases query, return a comma separated value (CSV) file of the cases found.
  • POSTEnforcement Case Download Data Service/case_rest_services.get_downloadBased on the QID obtained from a get_cases query, return a comma separated value (CSV) file of the cases found.
  • GETPlaceholder/case_rest_services.get_facilities_from_case?p_id=string&output=JSONP&callback=string
  • POSTPlaceholder/case_rest_services.get_facilities_from_case?p_id=string&output=JSONP&callback=string
  • GETEnforcement Case Map Service/case_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.0The purpose of the GET_MAP service is to display facility coordinates and facility clusters related to a get_cases query. Currently, the maximum number of…
  • POSTEnforcement Case Map Service/case_rest_services.get_mapThe purpose of the GET_MAP service is to display facility coordinates and facility clusters related to a get_cases query. Currently, the maximum number of…
  • GETEnforcement Case Paginated Results Service/case_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_cases query. It then returns a CASES object containing all matching cases. The main…
  • POSTEnforcement Case Paginated Results Service/case_rest_services.get_qidGET_QID is passed with a query ID corresponding to a previously run get_cases query. It then returns a CASES object containing all matching cases. The main…

Metadata

  • GETEnforcement Case Metadata Service/case_rest_services.metadata?output=JSONP&callback=stringReturns the JSON Object Name and ColumnId for usage with the qcolumns parameter for get_cases endpoint.
  • POSTEnforcement Case Metadata Service/case_rest_services.metadataReturns the JSON Object Name and ColumnId for usage with the qcolumns parameter for get_cases endpoint.

Lookups

  • GETECHO ICIS 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 Law Section Descriptions.
  • POSTECHO ICIS Law Sections Lookup Service/rest_lookups.icis_law_sectionsReturns the ICIS Law Section Descriptions.

API details

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

How to test the U.S. EPA Enforcement and Compliance History Online (ECHO) - Enforcement Case Se… 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) - Enforcement Case Se… 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 “Enforcement Case Search (new version)” (GET /case_rest_services.get_case_info?output=JSONP&p_case_category=string&p_case_status=string&p_milestone=string&p_from_date=string&p_to_date=string&p_milestone_fy=string&p_name=string&p_name_type=string&p_case_number=string&p_docket_number=string&p_court_docket_number=string&p_activity_number=string&p_case_lead=E&p_case_sens_flg=string&p_region=01&p_state=string&p_district=string&p_sic=string&p_sic_ao_naics=AND&p_sic_primary_flg=Y&p_sic_frs_flg=Y&p_naics=string&p_naics_primary_flg=Y&p_naics_frs_flg=Y&p_enf_type=string&p_law=string&p_section=string&p_cp_citation=string&p_rank_order=1&p_enf_program=string&p_violation=string&p_priority_area=string&p_priority_area_desc=string&p_tribal=Y&p_oeca_core=Y&p_multimedia=Y&p_fed_case=Y&p_activity_contact=string&p_role=string&p_fed_penalty=ANY&p_total_fed_penalty=string&p_cost_recovery=string&p_total_cost_recovery=string&p_complying_actions=string&p_comp_act_val=ANY&p_total_comp_act_val=string&p_sep_cats=string&p_sep_val=ANY&p_total_sep_val=string&p_lodged_date=string&p_entered_date=string&p_facility_id=string&p_fac_city=string&p_fac_zip=string&p_fac_county=string&p_case_summary=string&p_case_summary_type=ALL&p_usmex=Y&p_c1lat=0.0&p_c1lon=0.0&p_c2lat=0.0&p_c2lon=0.0&p_voluntary=string&p_fed_indicator=string&p_fntype=ALL&p_civil_criminal_indicator=CI&queryset=0.0&responseset=0.0&mapset=1400&callback=string&qcolumns=string&p_pretty_print=0.0&p_ocmap_fy=string&p_qs=string&p_has_map=string), 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) - Enforcement Case Se…?

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

Who publishes the U.S. EPA Enforcement and Compliance History Online (ECHO) - Enforcement Case Se…?

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) - Enforcement Case Se…?

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) - Enforcement Case Se…?

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) - Enforcement Case Se… have?

22 operations on 11 paths (11 GET, 11 POST). The largest groups are Case Enforcement, Lookups, Metadata.

Is forking the U.S. EPA Enforcement and Compliance History Online (ECHO) - Enforcement Case Se… 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.