U.S. EPA Enforcement and Compliance History Online (ECHO) - All Data — Facility Info

naftiko: 1.0.0-alpha2
info:
  label: U.S. EPA Enforcement and Compliance History Online (ECHO) - All Data — Facility Info
  description: 'Facility Info. 14 operations. Lead operation: Combined ECHO Download Data Service. Self-contained Naftiko capability covering one EPA business surface.'
  tags:
    - EPA
    - Facility Info
  created: '2026-05-29'
  modified: '2026-05-29'
binds:
  - namespace: env
    keys: {}
capability:
  consumes:
    - type: http
      namespace: echo-all-facility-info
      baseUri: https://echodata.epa.gov/echo
      description: U.S. EPA Enforcement and Compliance History Online (ECHO) - All Data — Facility Info business capability. Self-contained, no shared references.
      resources:
        - name: echo-rest-services-get-download
          path: /echo_rest_services.get_download
          operations:
            - name: getechorestservicesgetdownload
              method: GET
              description: Combined ECHO Download Data Service
              inputParameters:
                - name: output
                  in: query
                  type: string
                  required: false
                  description: "Output Format Flag.  Enter one of the following keywords:\n- CSV = Facility results formatted as comma delimited file download (default).\n- GEOJSOND = Facility results formatted as GeoJSON feature coll"
                - name: qid
                  in: query
                  type: string
                  required: true
                  description: Query ID Selector.  Enter the QueryID number from a previously run query.
                - name: qcolumns
                  in: query
                  type: string
                  required: false
                  description: Used to customize service output.  A list of comma-separated column IDs of output objects that will be returned in the service query object or download.  Use the metadata service endpoint for a comple
                - name: p_pretty_print
                  in: query
                  type: number
                  required: false
                  description: Optional flag to request GeoJSON formatted results to be pretty printed.  Only provide a numeric value when the output needs to be human readable as pretty printing has a performance cost.
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: echo-rest-services-get-download
          path: /echo_rest_services.get_download
          operations:
            - name: postechorestservicesgetdownload
              method: POST
              description: Combined ECHO Download Data Service
              inputParameters:
                - name: output
                  in: formData
                  type: string
                  required: false
                  description: "Output Format Flag.  Enter one of the following keywords:\n- CSV = Facility results formatted as comma delimited file download (default).\n- GEOJSOND = Facility results formatted as GeoJSON feature coll"
                - name: qid
                  in: formData
                  type: string
                  required: true
                  description: Query ID Selector.  Enter the QueryID number from a previously run query.
                - name: qcolumns
                  in: formData
                  type: string
                  required: false
                  description: Used to customize service output.  A list of comma-separated column IDs of output objects that will be returned in the service query object or download.  Use the metadata service endpoint for a comple
                - name: p_pretty_print
                  in: formData
                  type: number
                  required: false
                  description: Optional flag to request GeoJSON formatted results to be pretty printed.  Only provide a numeric value when the output needs to be human readable as pretty printing has a performance cost.
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: echo-rest-services-get-facilities
          path: /echo_rest_services.get_facilities
          operations:
            - name: getechorestservicesgetfacilities
              method: GET
              description: Combined ECHO Facility Search Service
              inputParameters:
                - name: output
                  in: query
                  type: string
                  required: false
                  description: "Output Format Flag.  Enter one of the following keywords:\n- JSON = Data model formatted as Javascript Object Notation (default).\n- JSONP = Data model formatted as Javascript Object Notation with Paddi"
                - name: p_fn
                  in: query
                  type: string
                  required: false
                  description: Facility Name Filter. Enter one or more case-insensitive facility names to filter results.  Provide multiple values as a comma-delimited list.  See p_fntype for additional modifiers.
                - name: p_sa
                  in: query
                  type: string
                  required: false
                  description: Facility street address. Enter a complete or partial street address.
                - name: p_sa1
                  in: query
                  type: string
                  required: false
                  description: Facility street address. Enter a complete or partial street address.   Note that p_sa1 is culmulative with p_sa.
                - name: p_ct
                  in: query
                  type: string
                  required: false
                  description: Facility City Filter. Enter a single case-insensitive city name to filter results.
                - name: p_co
                  in: query
                  type: string
                  required: false
                  description: Facility County Filter. Provide a single county name in combination with a state value provided via p_st.
                - name: p_fips
                  in: query
                  type: string
                  required: false
                  description: FIPS Code Filter.  Enter a single 5-character Federal Information Processing Standards (FIPS) state + county value to restrict results.  E.g. to limit results to Kenosha County, Wisconsin, use 55059.
                - name: p_st
                  in: query
                  type: string
                  required: false
                  description: Facility State and State-Equivalent Filter.  Provide one or more USPS postal abbreviations for states and state-equivalents to filter results.  Provide multiple values as a comma-delimited list.
                - name: p_zip
                  in: query
                  type: string
                  required: false
                  description: 5-Digit ZIP Code Filter. Provide one or more 5-digit postal zip codes to filter results.  May contain multiple comma-separated values.
                - name: p_frs
                  in: query
                  type: string
                  required: false
                  description: Facility Registry Service ID Filter. Enter a single 12-digit FRS identifier to filter results.
                - name: p_reg
                  in: query
                  type: string
                  required: false
                  description: EPA Region Filter. Provide a single value of 01 thru 10 to restrict results to a single EPA region.
                - name: p_sic
                  in: query
                  type: string
                  required: false
                  description: Standard Industrial Classification (SIC) Code Filter.  Enter a single 4-digit SIC Code to filter results.  If more complex filtering is required, use p_sic2 and p_sic4.
                - name: p_ncs
                  in: query
                  type: string
                  required: false
                  description: 'North American Industry Classification System Filter. Enter two to six digits to filter results to facilities having matching NAICS codes.  Digits less than six will match to all codes beginning with '
                - name: p_pen
                  in: query
                  type: string
                  required: false
                  description: "Last Penality Date Qualifier Filter.  Enter one of the following:   \n- NEVER = No Penalties\n- ANY = Any Penalty\n- LEXX = Less than or equal to XX months.  Provide a number in place of XX, e.g. \"LE5\" f"
                - name: p_c1lat
                  in: query
                  type: number
                  required: false
                  description: In decimal degrees.  Latitude of 1st corner of box that bounds the resulting facilities. The latitude and longitude of both corners of the bounding box must be provided.
                - name: p_c1lon
                  in: query
                  type: number
                  required: false
                  description: In decimal degrees.  Longitude of 1st corner of box that bounds the resulting facilities. The latitude and longitude of both corners of the bounding box must be provided.
                - name: p_c2lat
                  in: query
                  type: number
                  required: false
                  description: In decimal degrees.  Latitude of 2nd corner of box that bounds the resulting facilities. The latitude and longitude of both corners of the bounding box must be provided.
                - name: p_c2lon
                  in: query
                  type: number
                  required: false
                  description: In decimal degrees.  Longitude of 2nd corner of box that bounds the resulting facilities. The latitude and longitude of both corners of the bounding box must be provided.
                - name: p_usmex
                  in: query
                  type: string
                  required: false
                  description: US-Mexico Border Flag.  Enter Y/N to restrict searches to facilities located within 100KM of the border.
                - name: p_sic2
                  in: query
                  type: string
                  required: false
                  description: Standard Industrial Classification (SIC) Code Filter Alternate 2. Enter a wild-card search against SIC codes.  A final wild-card is always present allowing "22" to match all SIC codes beginning with 2
                - name: p_sic4
                  in: query
                  type: string
                  required: false
                  description: Standard Industrial Classification (SIC) Code Filter Alternate 3.  Enter the first 2, 3 or 4 SIC code digits to filter results to facilities having those code prefixes.  As this alternative does not u
                - name: p_fa
                  in: query
                  type: string
                  required: false
                  description: Federal Agency. 1 character or 5-character values; may contain multiple comma-separated values. ALL will retrieve all facilities where the federal agency code is not null.  Use the Federal Agencies lo
                - name: p_ff
                  in: query
                  type: string
                  required: false
                  description: Federal Facility Indicator Flag. Enter Y to restrict searches to federal facilities.
                - name: p_act
                  in: query
                  type: string
                  required: false
                  description: Active Permits/Facilities Flag.  Provide Y or N to filter results to facilities with active permits.
                - name: p_maj
                  in: query
                  type: string
                  required: false
                  description: Major Facility Flag.  Enter Y to restrict results to Major facilities only.
                - name: p_mact
                  in: query
                  type: string
                  required: false
                  description: CAA Maximum Achievable Control Technology (MACT) Subpart codes (alpha ID between 1 and 7 characters) applicable to the facility.
                - name: p_fea
                  in: query
                  type: string
                  required: false
                  description: "Formal Enforcement Actions [within / not within] specified date range indicator. The date range is determined by parameters p_fead1 and p_fead2 or by parameter p_feay.\n- W = within date range\n- N = no"
                - name: p_feay
                  in: query
                  type: number
                  required: false
                  description: Years (1 to 5) Range.  This value is used to create a date range for Formal Enforcement Actions (FEA). Used along with p_fea (which indicates whether to look within or outside of the date range) to fi
                - name: p_feaa
                  in: query
                  type: string
                  required: false
                  description: "Agency associated with Formal Enforcement Actions:\n- E = EPA\n- S = State\n- A = All"
                - name: p_feac
                  in: query
                  type: string
                  required: false
                  description: Formal Enforcment Action Last Case Date Limiter Flag.  Enter a value of "Y" to additionally apply the p_feay year filter to the last formal enforcement action case date.  Use the p_fea parameter to co
                - name: p_fea_5yr
                  in: query
                  type: string
                  required: false
                  description: A Y value identifies facilities that have had a formal enforcement action within the last 5 years.
                - name: p_iea
                  in: query
                  type: string
                  required: false
                  description: "Informal Enforcement Actions [within / not within] specified date range.  The date range is determined by parameters p_iead1 and p_iead2 or by parameter p_ieay.\n- W = within date range\n- N = not withi"
                - name: p_ieay
                  in: query
                  type: number
                  required: false
                  description: 'Years (1 to 5) Range.  This value is used to create a date range for Informal Enforcement Actions (IEA). Used along with p_iea (which indicates whether to look within or outside of the date range) to '
                - name: p_ieaa
                  in: query
                  type: string
                  required: false
                  description: "Agency associated with Informal Enforcement Actions. If left blank, both agencies are included.\n- E = EPA\n- S = State"
                - name: p_iea_5yr
                  in: query
                  type: string
                  required: false
                  description: A Y value identifies facilities that have had an informal enforcement action within the last 5 years.
                - name: p_cs
                  in: query
                  type: number
                  required: false
                  description: "Facility Compliance Limiter.  Enter 2, 3 or 4 to limit facilities returned.\n- 2 = Facilities in noncompliance.\n- 3 = Facilities having one or more programs reporting significant noncompliance.\n- 4 = F"
                - name: p_qiv
                  in: query
                  type: string
                  required: false
                  description: "Quarters in Noncompliance Limiter.  Enter a coded value to limit results to facilities with given quarter of noncompliance.\n- Z = Zero quarters in noncompliance.\n- GEXX = Replacing XX with a numeric v"
                - name: p_naa
                  in: query
                  type: string
                  required: false
                  description: Non-Attainment Area Flag.  Enter a Y or N to filter for or against facilities flagged as non-attainment areas.
                - name: p_impw
                  in: query
                  type: string
                  required: false
                  description: Discharging into Impaired Waters Flag. Enter Y to limit results to facilities with discharge to waterbodies listed as impaired in the ATTAINS database.
                - name: p_trep
                  in: query
                  type: string
                  required: false
                  description: "Current Toxics Release Inventory (TRI) Reporter Limiter.  Enter one of the following codes to limit results.\n- CURR = Current TRI reporter.\n- NONCURR = Has reported to TRI in the past but not for the "
                - name: p_ocr
                  in: query
                  type: string
                  required: false
                  description: "Toxics Release Inventory Pounds of On-Site Chemical Releases Limiter.  Enter a keyword to filter results.\n- Z = Zero pounds of chemical releases.\n- GT0 = More than zero pounds of chemical releases.\n- "
                - name: p_oct
                  in: query
                  type: string
                  required: false
                  description: "Toxic Release Inventory Pounds of Off-Site Chemical Releases Limiter.  Enter a keyword to filter results.\n- Z = Zero pounds of chemical releases.\n- GT0 = More than zero pounds of chemical releases.\n- "
                - name: p_pm
                  in: query
                  type: string
                  required: false
                  description: "Percent Minority Population Limiter.  Enter a value to restrict results to facilities with a given percentage of minority population within 3-mile radius.\n- NONE = 0%\n- GT5 = greater than 5%\n- GT10 = "
                - name: p_pd
                  in: query
                  type: string
                  required: false
                  description: "Population Density Limiter (per sq mile). Enter a value to limit results to facilities located in area of a given population density.\n- NONE = 0 population density per square mile\n- GT100 = More than "
                - name: p_ico
                  in: query
                  type: string
                  required: false
                  description: Indian Country Flag.  Enter a "Y" or "N" to restrict searches to facilities inside or outside Indian Country.
                - name: p_huc
                  in: query
                  type: string
                  required: false
                  description: 2-, 4-, 6-, or 8-character watershed code. May contain multiple comma-separated values.
                - name: p_pid
                  in: query
                  type: string
                  required: false
                  description: Nine-digit permit IDs. May contain up to 2000 comma-separated values.
                - name: p_med
                  in: query
                  type: string
                  required: false
                  description: Filter Results by Media.- A = Air- C = CAMD (Clean Air Markets Division)- E = EIS (Emissions Inventory Systems)- G = GHG (Greenhouse Gases)- M = RMP (Risk Management Plan)- R = RCRA (Hazardous Waste)-
                - name: p_istatute
                  in: query
                  type: string
                  required: false
                  description: For use in identifying Facilities that have an inspection performed under the entered Statute.
                - name: p_ysl
                  in: query
                  type: string
                  required: false
                  description: "Last Facility Inspection [within / not within] Specified Date Range Indicator. The date range is determined by parameters p_idt1 and p_idt2 or by parameter p_ysly.\n- W = within date range\n- N = not wi"
                - name: p_ysly
                  in: query
                  type: number
                  required: false
                  description: Number of years (1 to 5) since last facility inspection.  A value of 1 means that it has been inspected within the year.
                - name: p_ysla
                  in: query
                  type: string
                  required: false
                  description: "Facility Last Inspection Code Filter.  If left blank, both agencies are included.  Enter a value to limit results:\n- E = EPA\n- S = State"
                - name: p_qs
                  in: query
                  type: string
                  required: false
                  description: Quick Search. Allows entry for city, state, and/or zip code.
                - name: p_sfs
                  in: query
                  type: string
                  required: false
                  description: Single Facility Search Filter.  Provide a facility name or program system identifier to limit results.  For the all data search, the FRS registry identifier is also searched.
                - name: p_tribeid
                  in: query
                  type: number
                  required: false
                  description: Numeric code for tribe (or list of tribes).
                - name: p_tribename
                  in: query
                  type: string
                  required: false
                  description: Tribe Name Filter.  Enter a single tribe name to filter results.
                - name: p_tribedist
                  in: query
                  type: number
                  required: false
                  description: Proximity to tribal land limiter. Enter an amount of mile between 0 and 25 to filter results.  This parameter is only evaluated if p_tribeid is populated.
                - name: p_wbd
                  in: query
                  type: string
                  required: false
                  description: 2-, 4-, 6-, 8-, 10-, or 12-character watershed (WBD from the USGS Watershed Boundary Dataset). May contain multiple comma-separated values.  Uses the FRS Best Pick Coordinate to obtain the WBD12 Huc v
                - name: p_fntype
                  in: query
                  type: string
                  required: false
                  description: "Controls type of text search performed on facility name with parameter p_fn.\n- EXACT = Find facilities having the exact provided name(s).\n- BEGINS = Find facilities with names starting with the provid"
                - name: p_icoo
                  in: query
                  type: string
                  required: false
                  description: Indian country search and/or flag.  Enter "Y" to set indian country search conditions to return any results found using p_ico, p_fac_ico or p_fac_icoo.  Otherwise only results matching all provided p_
                - name: p_fac_icos
                  in: query
                  type: string
                  required: false
                  description: FRS tribal land spatial flag.  Enter "Y" or "N" to include or exclude facilities based on FRS tribal land spatial flag.
                - name: p_ejscreen
                  in: query
                  type: string
                  required: false
                  description: Enter "Y" to limit facilities to Census block groups where one of more Environmental Justice indexes above 80th percentile.
                - name: p_limit_addr
                  in: query
                  type: string
                  required: false
                  description: 'Limit Address Search Flag.  Enter Y to restrict facility searches to native data source only.  '
                - name: p_lat
                  in: query
                  type: number
                  required: false
                  description: Latitude location in decimal degrees.
                - name: p_long
                  in: query
                  type: number
                  required: false
                  description: Longitude location in decimal degrees.
                - name: p_radius
                  in: query
                  type: number
                  required: false
                  description: Spatial Search Radius.  Enter a radius up to 100 miles in which to spatially search for facilities.
                - name: p_ejscreen_over80cnt
                  in: query
                  type: string
                  required: false
                  description: The number of Environmenmt Justice Indicators above the 80th percentile.  Valid values are 1 through 11.
                - name: p_agoo
                  in: query
                  type: string
                  required: false
                  description: Indicates whether to AND or OR the Owner/Operator parameter (p_owop) and the federal agency code (p_fa) parameters.
                - name: p_neiu
                  in: query
                  type: string
                  required: false
                  description: p_neiu
                - name: queryset
                  in: query
                  type: number
                  required: false
                  description: Query Limiter.  Enter a value to limit the number of records returned for each query. Value cannot exceed 70,000.
                - name: responseset
                  in: query
                  type: number
                  required: false
                  description: Response Set Limiter. Enter a value to limit the number of records per page. Value cannot exceed 1,000.
                - name: tablelist
                  in: query
                  type: string
                  required: false
                  description: Table List Flag. Enter a Y to display the first page of facility results.
                - name: maplist
                  in: query
                  type: string
                  required: false
                  description: Map List Flag.  Provide a Y to return mappable coordinates representing the full geographic extent of the queryset (all facilities that met the selection criteria).
                - name: summarylist
                  in: query
                  type: string
                  required: false
                  description: Summary List Flag.  Enter a Y to return a list of summary statistics based on the parameters submitted to the query service.
                - name: callback
                  in: query
                  type: string
                  required: false
                  description: JSONP Callback.  For use with JSONP and GEOJSONP output only.  Enter a name of the function in which to wrap the JSON response.
                - name: qcolumns
                  in: query
                  type: string
                  required: false
                  description: Used to customize service output.  A list of comma-separated column IDs of output objects that will be returned in the service query object or download.  Use the metadata service endpoint for a comple
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: echo-rest-services-get-facilities
          path: /echo_rest_services.get_facilities
          operations:
            - name: postechorestservicesgetfacilities
              method: POST
              description: Combined ECHO Facility Search Service
              inputParameters:
                - name: output
                  in: formData
                  type: string
                  required: false
                  description: "Output Format Flag.  Enter one of the following keywords:\n- JSON = Data model formatted as Javascript Object Notation (default).\n- JSONP = Data model formatted as Javascript Object Notation with Paddi"
                - name: p_fn
                  in: formData
                  type: string
                  required: false
                  description: Facility Name Filter. Enter one or more case-insensitive facility names to filter results.  Provide multiple values as a comma-delimited list.  See p_fntype for additional modifiers.
                - name: p_sa
                  in: formData
                  type: string
                  required: false
                  description: Facility street address. Enter a complete or partial street address.
                - name: p_sa1
                  in: formData
                  type: string
                  required: false
                  description: Facility street address. Enter a complete or partial street address.   Note that p_sa1 is culmulative with p_sa.
                - name: p_ct
                  in: formData
                  type: string
                  required: false
                  description: Facility City Filter. Enter a single case-insensitive city name to filter results.
                - name: p_co
                  in: formData
                  type: string
                  required: false
                  description: Facility County Filter. Provide a single county name in combination with a state value provided via p_st.
                - name: p_fips
                  in: formData
                  type: string
                  required: false
                  description: FIPS Code Filter.  Enter a single 5-character Federal Information Processing Standards (FIPS) state + county value to restrict results.  E.g. to limit results to Kenosha County, Wisconsin, use 55059.
                - name: p_st
                  in: formData
                  type: string
                  required: false
                  description: Facility State and State-Equivalent Filter.  Provide one or more USPS postal abbreviations for states and state-equivalents to filter results.  Provide multiple values as a comma-delimited list.
                - name: p_zip
                  in: formData
                  type: string
                  required: false
                  description: 5-Digit ZIP Code Filter. Provide one or more 5-digit postal zip codes to filter results.  May contain multiple comma-separated values.
                - name: p_frs
                  in: formData
                  type: string
                  required: false
                  description: Facility Registry Service ID Filter. Enter a single 12-digit FRS identifier to filter results.
                - name: p_reg
                  in: formData
                  type: string
                  required: false
                  description: EPA Region Filter. Provide a single value of 01 thru 10 to restrict results to a single EPA region.
                - name: p_sic
                  in: formData
                  type: string
                  required: false
                  description: Standard Industrial Classification (SIC) Code Filter.  Enter a single 4-digit SIC Code to filter results.  If more complex filtering is required, use p_sic2 and p_sic4.
                - name: p_ncs
                  in: formData
                  type: string
                  required: false
                  description: 'North American Industry Classification System Filter. Enter two to six digits to filter results to facilities having matching NAICS codes.  Digits less than six will match to all codes beginning with '
                - name: p_pen
                  in: formData
                  type: string
                  required: false
                  description: "Last Penality Date Qualifier Filter.  Enter one of the following:   \n- NEVER = No Penalties\n- ANY = Any Penalty\n- LEXX = Less than or equal to XX months.  Provide a number in place of XX, e.g. \"LE5\" f"
                - name: p_c1lat
                  in: formData
                  type: number
                  required: false
                  description: In decimal degrees.  Latitude of 1st corner of box that bounds the resulting facilities. The latitude and longitude of both corners of the bounding box must be provided.
                - name: p_c1lon
                  in: formData
                  type: number
                  required: false
                  description: In decimal degrees.  Longitude of 1st corner of box that bounds the resulting facilities. The latitude and longitude of both corners of the bounding box must be provided.
                - name: p_c2lat
                  in: formData
                  type: number
                  required: false
                  description: In decimal degrees.  Latitude of 2nd corner of box that bounds the resulting facilities. The latitude and longitude of both 

# --- truncated at 32 KB (148 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/epa/refs/heads/main/capabilities/echo-all-facility-info.yaml