Permit and zoning data

Query normalized EPA ECHO ICIS-NPDES non-effluent violation rows

Returns R2-backed EPA ECHO ICIS-NPDES permit-schedule, compliance-schedule, and single-event violation rows with permit, violation-code, RNC detection/resolution, linked-enforcement count, partition, and source-manifest context. This endpoint is public context, not an autonomous settlement oracle until refresh, checksum, revision-window, effluent/limits, detailed enforcement-action, and resolver policies are published.

get/api/v1/data/environmental/epa-echo/npdes-violations

Request

  • Base URL: https://www.homecastr.com
  • URL: https://www.homecastr.com/api/v1/data/environmental/epa-echo/npdes-violations
  • Auth: none declared

Query parameters

statestring
Example:TX

2-letter permit state prefix. Required unless permit_id or summary=true is supplied.

permit_idstring
Example:TX0020478

Exact NPDES permit identifier. If state is omitted, the first two permit characters are used as the state partition.

category'permit_schedule' | 'compliance_schedule' | 'single_event'
Example:single_event

Violation category filter.

violation_codestring
Example:C40

ICIS violation code filter.

rnc_detection_codestring

RNC detection code filter.

rnc_resolution_codestring

RNC resolution code filter.

yearinteger
Example:2020

Calendar year based on violation, schedule, RNC detection, or actual date.

has_linked_enforcementboolean

Filter by whether a violation row has one or more linked enforcement-action rows.

limitinteger

Maximum records to return.

summaryboolean

Return manifest and partition metadata without row payloads.

Response

EPA ECHO ICIS-NPDES violations response.

schema_idstring required
asset_idstring required
source_idstring required
data_snapshot_idstring required
record_countinteger required
filtersobject required
_linksobject required

Example response

{
  "schema_id": "hc.epa_echo_npdes_violation.v1",
  "asset_id": "context.epa_echo_npdes_violations",
  "source_id": "epa_echo_npdes_violations",
  "manifest": {
    "schema_id": "hc.epa_echo_npdes_violation_manifest.v1",
    "run_id": "20260718T204822+0000",
    "source_id": "epa_echo_npdes_violations",
    "record_count": 782170,
    "partition_count": 286,
    "partition_payload_bytes": 40549489,
    "enforcement_link_count": 4928870,
    "records_with_linked_enforcement": 155949
  },
  "partitions": [
    {
      "state_code": "TX",
      "category": "single_event",
      "record_count": 5000,
      "bytes": 257535,
      "uncompressed_bytes": 7738672,
      "content_encoding": "gzip"
    }
  ],
  "records": [
    {
      "schema_id": "hc.epa_echo_npdes_violation.v1",
      "record_id": "epa_echo_npdes_violations:TX:single_event:TX0020478:12345",
      "source_id": "epa_echo_npdes_violations",
      "enforcement": {
        "linked_action_count": 1
      }
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.