---
title: "Query normalized EPA ECHO NPDES current sewer-overflow event rows"
method: GET
path: "/api/v1/data/environmental/epa-echo/npdes-sewer-overflows"
tags: ["Permit and zoning data"]
---

# Query normalized EPA ECHO NPDES current sewer-overflow event rows

`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

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.

## Query parameters

- `state` string
- `permit_id` string
- `event_type` string
- `year` integer
- `min_volume_gallons` number
- `with_coordinates` boolean
- `limit` integer
- `summary` boolean

## Response `200`

EPA ECHO NPDES sewer-overflow event response.

- EpaEchoNpdesSewerOverflowResponse
  - `schema_id` string, required
  - `asset_id` string, required
  - `source_id` string, required
  - `data_snapshot_id` string, required
  - `record_count` integer, required
  - `filters` object, required
  - `manifest` EpaEchoNpdesSewerOverflowManifestSummary, required
    - `schema_id` string, required
    - `generated_at` string, date-time, required
    - `run_id` string, required
    - `source_id` string, required
    - `source_official_url` string, uri, required
    - `source_page_url` string, uri, required
    - `source_snapshot_id` string, required
    - `source_uri` string, required
    - `normalized_prefix_uri` string, required
    - `event_payload_uri` string, required
    - `event_payload_public_path` string, required
    - `event_payload_bytes` integer, required
    - `table_counts` object, required
    - `event_count` integer, required
    - `permit_count` integer, required
    - `events_with_coordinates` integer, required
    - `events_with_volume` integer, required
    - `reported_volume_gallons_sum` number, required
    - `state_counts` object, required
    - `event_type_counts` object, required
    - `structure_type_counts` object, required
    - `settlement_policy` object, required
  - `records` EpaEchoNpdesSewerOverflowRecord[], required
    - `schema_id` string, required
    - `record_id` string, required
    - `source_id` string, required
    - `source_record_id` string, required
    - `source_snapshot_id` string, required
    - `source_uri` string, required
    - `source_official_url` string, uri, required
    - `source_page_url` string, uri, required
    - `normalization_version` string, required
    - `permit` object, required
      - `permit_id` string, nullable
      - `state_code` string, nullable
      - `collection_system_identifier` string, nullable
      - `permitted_feature_identifier` string, nullable
      - `collection_system` object, nullable
        - `name` string, nullable
        - `owner_type_code` string, nullable
        - `owner_type_desc` string, nullable
        - `population` number, nullable
        - `percent_combined_sewer_system` number, nullable
    - `report` object, required
      - `program_report_form_set_id` string, nullable
      - `program_report_form_id` string, nullable
      - `event_id_external` string, nullable
      - `received_date` string, nullable
      - `start_date` string, nullable
      - `end_date` string, nullable
      - `payload_id` string, nullable
      - `transaction_type` string, nullable
      - `event_transaction_type` string, nullable
      - `electronic_submission_type_code` string, nullable
      - `electronic_submission_type_desc` string, nullable
    - `event` object, required
      - `description` string, nullable
      - `reporting_requirement_code` string, nullable
      - `reporting_requirement_desc` string, nullable
      - `wet_weather` boolean, nullable
      - `structure_type_code` string, nullable
      - `structure_type_desc` string, nullable
      - `structure_type_other_text` string, nullable
      - `duration_hours` number, nullable
      - `start_datetime` string, nullable
      - `end_datetime` string, nullable
      - `discharge_quantification_method_code` string, nullable
      - `discharge_quantification_method_desc` string, nullable
      - `discharge_volume_gallons` number, nullable
      - `discharge_rate_gph` number, nullable
      - `anticipated_bypass_text` string, nullable
      - `anticipated_bypass_expect_limit_violation` boolean, nullable
      - `anticipated_bypass_expect_limit_violation_text` string, nullable
    - `location` object, required
      - `latitude` number, nullable
      - `longitude` number, nullable
    - `related` object, required
      - `types` object[]
      - `causes` object[]
      - `impacts` object[]
      - `corrective_actions` object[]
      - `receiving_waters` object[]
      - `treatment_codes` object[]
    - `quality_flags` string[], required
    - `published_at` string, date-time, required
  - `access` DataAccessSummary, required
    - `visibility` 'public' | 'metadata_only' | 'restricted' | 'unavailable', required
    - `support_level` string, required
    - `sensitivity` string, required
    - `training_eligibility` 'benchmark_only' | 'consumer_feed' | 'training_candidate' | 'holdback', required
    - `license_status` string, required
  - `_links` object, required

## Other responses

- `400`: Invalid query parameters.

---

[API](https://skmtc.dev/worldcastr/apis/worldcastr-api.md) · [All operations](https://skmtc.dev/worldcastr/apis/worldcastr-api/llms.txt) · [OpenAPI document](https://skmtc.dev/worldcastr/apis/worldcastr-api/revisions/2cf1606dc8e1?raw)