U.S. EPA Enforcement and Compliance History Online (ECHO) - Clean Water Act (CWA) Rest Services — Lookups

naftiko: 1.0.0-alpha2
info:
  label: U.S. EPA Enforcement and Compliance History Online (ECHO) - Clean Water Act (CWA) Rest Services — Lookups
  description: 'Lookups. 20 operations. Lead operation: ECHO BP Tribes Lookup Service. Self-contained Naftiko capability covering one EPA business surface.'
  tags:
    - EPA
    - Lookups
  created: '2026-05-29'
  modified: '2026-05-29'
binds:
  - namespace: env
    keys: {}
capability:
  consumes:
    - type: http
      namespace: echo-cwa-lookups
      baseUri: https://echodata.epa.gov/echo
      description: U.S. EPA Enforcement and Compliance History Online (ECHO) - Clean Water Act (CWA) Rest Services — Lookups business capability. Self-contained, no shared references.
      resources:
        - name: rest-lookups-bp-tribes
          path: /rest_lookups.bp_tribes
          operations:
            - name: getrestlookupsbptribes
              method: GET
              description: ECHO BP Tribes Lookup 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: 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: search_term
                  in: query
                  type: string
                  required: false
                  description: Enter a partial or complete search phrase or word.
                - name: search_code
                  in: query
                  type: string
                  required: false
                  description: Enter a partial or complete code value.
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: rest-lookups-bp-tribes
          path: /rest_lookups.bp_tribes
          operations:
            - name: postrestlookupsbptribes
              method: POST
              description: ECHO BP Tribes Lookup 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: callback
                  in: formData
                  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: search_term
                  in: formData
                  type: string
                  required: false
                  description: Enter a partial or complete search phrase or word.
                - name: search_code
                  in: formData
                  type: string
                  required: false
                  description: Enter a partial or complete code value.
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: rest-lookups-cwa-parameters
          path: /rest_lookups.cwa_parameters
          operations:
            - name: getrestlookupscwaparameters
              method: GET
              description: ECHO CWA Parameter Lookup 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: 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: search_term
                  in: query
                  type: string
                  required: false
                  description: Enter a partial or complete search phrase or word.
                - name: search_code
                  in: query
                  type: string
                  required: false
                  description: Enter a partial or complete code value.
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: rest-lookups-cwa-parameters
          path: /rest_lookups.cwa_parameters
          operations:
            - name: postrestlookupscwaparameters
              method: POST
              description: ECHO CWA Parameter Lookup 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: callback
                  in: formData
                  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: search_term
                  in: formData
                  type: string
                  required: false
                  description: Enter a partial or complete search phrase or word.
                - name: search_code
                  in: formData
                  type: string
                  required: false
                  description: Enter a partial or complete code value.
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: rest-lookups-cwa-pollutants
          path: /rest_lookups.cwa_pollutants
          operations:
            - name: getrestlookupscwapollutants
              method: GET
              description: ECHO CWA Pollutants Lookup 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: 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: search_term
                  in: query
                  type: string
                  required: false
                  description: Enter a partial or complete search phrase or word.
                - name: search_code
                  in: query
                  type: string
                  required: false
                  description: Enter a partial or complete code value.
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: rest-lookups-cwa-pollutants
          path: /rest_lookups.cwa_pollutants
          operations:
            - name: postrestlookupscwapollutants
              method: POST
              description: ECHO CWA Pollutants Lookup 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: callback
                  in: formData
                  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: search_term
                  in: formData
                  type: string
                  required: false
                  description: Enter a partial or complete search phrase or word.
                - name: search_code
                  in: formData
                  type: string
                  required: false
                  description: Enter a partial or complete code value.
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: rest-lookups-federal-agencies
          path: /rest_lookups.federal_agencies
          operations:
            - name: getrestlookupsfederalagencies
              method: GET
              description: ECHO Federal Agency Lookup 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: 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: search_term
                  in: query
                  type: string
                  required: false
                  description: Enter a partial or complete search phrase or word.
                - name: search_code
                  in: query
                  type: string
                  required: false
                  description: Enter a partial or complete code value.
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: rest-lookups-federal-agencies
          path: /rest_lookups.federal_agencies
          operations:
            - name: postrestlookupsfederalagencies
              method: POST
              description: ECHO Federal Agency Lookup 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: callback
                  in: formData
                  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: search_term
                  in: formData
                  type: string
                  required: false
                  description: Enter a partial or complete search phrase or word.
                - name: search_code
                  in: formData
                  type: string
                  required: false
                  description: Enter a partial or complete code value.
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: rest-lookups-icis-inspection-types
          path: /rest_lookups.icis_inspection_types
          operations:
            - name: getrestlookupsicisinspectiontypes
              method: GET
              description: ECHO ICIS NPDES Inspection Types Lookup 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: 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: search_term
                  in: query
                  type: string
                  required: false
                  description: Enter a partial or complete search phrase or word.
                - name: search_code
                  in: query
                  type: string
                  required: false
                  description: Enter a partial or complete code value.
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: rest-lookups-icis-inspection-types
          path: /rest_lookups.icis_inspection_types
          operations:
            - name: postrestlookupsicisinspectiontypes
              method: POST
              description: ECHO ICIS NPDES Inspection Types Lookup 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: callback
                  in: formData
                  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: search_term
                  in: formData
                  type: string
                  required: false
                  description: Enter a partial or complete search phrase or word.
                - name: search_code
                  in: formData
                  type: string
                  required: false
                  description: Enter a partial or complete code value.
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: rest-lookups-icis-law-sections
          path: /rest_lookups.icis_law_sections
          operations:
            - name: getrestlookupsicislawsections
              method: GET
              description: ECHO ICIS NPDES Law Sections Lookup 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: 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: statute_code
                  in: query
                  type: string
                  required: false
                  description: statute_code
                - name: status_flag
                  in: query
                  type: string
                  required: false
                  description: status_flag
                - name: search_term
                  in: query
                  type: string
                  required: false
                  description: Enter a partial or complete search phrase or word.
                - name: search_code
                  in: query
                  type: string
                  required: false
                  description: Enter a partial or complete code value.
                - name: sort_order
                  in: query
                  type: number
                  required: false
                  description: sort_order
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: rest-lookups-icis-law-sections
          path: /rest_lookups.icis_law_sections
          operations:
            - name: postrestlookupsicislawsections
              method: POST
              description: ECHO ICIS NPDES Law Sections Lookup 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: callback
                  in: formData
                  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: statute_code
                  in: formData
                  type: string
                  required: false
                  description: statute_code
                - name: status_flag
                  in: formData
                  type: string
                  required: false
                  description: status_flag
                - name: search_term
                  in: formData
                  type: string
                  required: false
                  description: Enter a partial or complete search phrase or word.
                - name: search_code
                  in: formData
                  type: string
                  required: false
                  description: Enter a partial or complete code value.
                - name: sort_order
                  in: formData
                  type: number
                  required: false
                  description: sort_order
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: rest-lookups-naics-codes
          path: /rest_lookups.naics_codes
          operations:
            - name: getrestlookupsnaicscodes
              method: GET
              description: ECHO NAICS Codes Lookup 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: 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: search_term
                  in: query
                  type: string
                  required: false
                  description: Enter a partial or complete search phrase or word.
                - name: search_code
                  in: query
                  type: string
                  required: false
                  description: Enter a partial or complete code value.
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: rest-lookups-naics-codes
          path: /rest_lookups.naics_codes
          operations:
            - name: postrestlookupsnaicscodes
              method: POST
              description: ECHO NAICS Codes Lookup 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: callback
                  in: formData
                  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: search_term
                  in: formData
                  type: string
                  required: false
                  description: Enter a partial or complete search phrase or word.
                - name: search_code
                  in: formData
                  type: string
                  required: false
                  description: Enter a partial or complete code value.
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: rest-lookups-npdes-parameters
          path: /rest_lookups.npdes_parameters
          operations:
            - name: getrestlookupsnpdesparameters
              method: GET
              description: ECHO NPDES Parameters Lookup 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: 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: search_term
                  in: query
                  type: string
                  required: false
                  description: Enter a partial or complete search phrase or word.
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: rest-lookups-npdes-parameters
          path: /rest_lookups.npdes_parameters
          operations:
            - name: postrestlookupsnpdesparameters
              method: POST
              description: ECHO NPDES Parameters Lookup 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: callback
                  in: formData
                  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: search_term
                  in: formData
                  type: string
                  required: false
                  description: Enter a partial or complete search phrase or word.
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: rest-lookups-wbd-code-lu
          path: /rest_lookups.wbd_code_lu
          operations:
            - name: getrestlookupswbdcodelu
              method: GET
              description: ECHO WBD Code Lookup 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: 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: wbd_code
                  in: query
                  type: string
                  required: false
                  description: Two-digit watershed code [Hydrologic Unit Code (HUC)].
                - name: wbd_level
                  in: query
                  type: string
                  required: false
                  description: The number of digits of the watershed code [Hydrologic Unit Code (HUC)] returned in the ValueCode. Must be an even number between 4 and 12.
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: rest-lookups-wbd-code-lu
          path: /rest_lookups.wbd_code_lu
          operations:
            - name: postrestlookupswbdcodelu
              method: POST
              description: ECHO WBD Code Lookup 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: callback
                  in: formData
                  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: wbd_code
                  in: formData
                  type: string
                  required: false
                  description: Two-digit watershed code [Hydrologic Unit Code (HUC)].
                - name: wbd_level
                  in: formData
                  type: string
                  required: false
                  description: The number of digits of the watershed code [Hydrologic Unit Code (HUC)] returned in the ValueCode. Must be an even number between 4 and 12.
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: rest-lookups-wbd-name-lu
          path: /rest_lookups.wbd_name_lu
          operations:
            - name: getrestlookupswbdnamelu
              method: GET
              description: ECHO WBD Name Lookup 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: 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: wbd_name
                  in: query
                  type: string
                  required: true
                  description: Watershed Name Filter.
                - name: wbd_level
                  in: query
                  type: string
                  required: false
                  description: The number of digits of the watershed code [Hydrologic Unit Code (HUC)] returned in the ValueCode. Must be an even number between 4 and 12.
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: rest-lookups-wbd-name-lu
          path: /rest_lookups.wbd_name_lu
          operations:
            - name: postrestlookupswbdnamelu
              method: POST
              description: ECHO WBD Name Lookup 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: callback
                  in: formData
                  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: wbd_name
                  in: formData
                  type: string
                  required: true
                  description: Watershed Name Filter.
                - name: wbd_level
                  in: formData
                  type: string
                  required: false
                  description: The number of digits of the watershed code [Hydrologic Unit Code (HUC)] returned in the ValueCode. Must be an even number between 4 and 12.
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
  exposes:
    - type: rest
      namespace: echo-cwa-lookups-rest
      port: 8080
      description: REST adapter for U.S. EPA Enforcement and Compliance History Online (ECHO) - Clean Water Act (CWA) Rest Services — Lookups. One Spectral-compliant resource per consumed operation, prefixed with /v1.
      resources:
        - path: /v1/rest_lookups.bp_tribes
          name: rest-lookups-bp-tribes
          description: REST surface for ECHO BP Tribes Lookup Service.
          operations:
            - method: GET
              name: getrestlookupsbptribes
              description: ECHO BP Tribes Lookup Service
              call: echo-cwa-lookups.getrestlookupsbptribes
              with:
                output: rest.output
                callback: rest.callback
                search_term: rest.search_term
                search_code: rest.search_code
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/rest_lookups.bp_tribes
          name: rest-lookups-bp-tribes
          description: REST surf

# --- truncated at 32 KB (55 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/epa/refs/heads/main/capabilities/echo-cwa-lookups.yaml