Permit and zoning data

Query normalized EPA ECHO NPDES current sewer-overflow event rows

Returns R2-backed EPA ECHO NPDES current sewer-overflow and bypass event rows with permit, event type, timing, reported discharge volume, receiving-water, coordinate, and source-manifest context. This endpoint is public context, not an autonomous settlement oracle until refresh, checksum, late/replacement report, and resolver policies are published.

get/api/v1/data/environmental/epa-echo/npdes-sewer-overflows

Request

  • Base URL: https://worldcastr.com
  • URL: https://worldcastr.com/api/v1/data/environmental/epa-echo/npdes-sewer-overflows
  • Auth: none declared

Query parameters

statestring
Example:IL

2-letter permit state prefix.

permit_idstring
Example:IL0029449

NPDES permit identifier.

event_typestring
Example:Sanitary Sewer Overflow

Event type text filter.

yearinteger
Example:2026

Event year from start datetime or report start date.

min_volume_gallonsnumber

Minimum reported discharge volume in gallons.

with_coordinatesboolean

Require latitude and longitude.

limitinteger

Maximum records to return.

summaryboolean

Return manifest and count metadata without row payloads.

Response

EPA ECHO NPDES sewer-overflow event 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_sewer_overflow_event.v1",
  "asset_id": "context.epa_echo_npdes_sewer_overflows",
  "source_id": "epa_echo_npdes_sewer_overflow_current",
  "manifest": {
    "schema_id": "hc.epa_echo_npdes_sewer_overflow_manifest.v1",
    "run_id": "20260718T190943+0000",
    "source_id": "epa_echo_npdes_sewer_overflow_current",
    "event_payload_bytes": 18036874,
    "event_count": 4685,
    "permit_count": 639,
    "events_with_coordinates": 3092,
    "events_with_volume": 3374,
    "reported_volume_gallons_sum": 7521279853.5
  },
  "records": [
    {
      "schema_id": "hc.epa_echo_npdes_sewer_overflow_event.v1",
      "record_id": "epa_echo_npdes_sewer_overflow_current:4199",
      "source_id": "epa_echo_npdes_sewer_overflow_current"
    }
  ]
}

Changes

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