Skip to main content

us-water-quality-data for Python

Versioned U.S. water-system evidence by ZIP for Python. Its bundled JSON is generated from the same open export as the JavaScript package and preserves measured zero, measured false, and unavailable evidence as different states.

import us_water_quality_data as water

record = water.lookup("10001")
print(record)
print(water.meta["total_zips"])

The package provides lookup, get_state, get_worst, get_best, states, count, zips, and search_city. Read coverage counts, source vintage, and field definitions from water.meta; they vary by version.

The copper field is copper_action_level_exceedance, not a concentration. It is True only when an accepted CU90 exceedance record exists and None when unknown. Nullable violation, CCR, enforcement, lead, radon, score, and grade fields must not be converted to reassuring zeros or false values.

Schema v5 has 55 ordered fields. ccr_accepted_evidence is None unless an accepted CCR record is source-bound to its identity, period/date status, typed lead result, copper semantics, evidence URL, and SHA-256.

lead_level_mg_l is normalized only from a source row with an explicit supported unit. Values at or above 1 mg/L are held for source review and are never divided by 1000 automatically. contaminant_count and health_contaminant_names are None when water_data_available is false.

Home Safety Score fields follow the model version recorded by the source export and remain unavailable when required domain coverage is incomplete. The data is system-level and geographically joined evidence, not tap-level sampling, a property inspection, or a guarantee of safety.

License: CC BY 4.0. Full source and methodology details: zipcheckup.com.

Metadata

Release files for us-water-quality-data 2026.10.23

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for us-water-quality-data 2026.10.23
File Size Uploaded Provenance
us_water_quality_data-2026.10.23.tar.gz 6.3 MB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for us-water-quality-data 2026.10.23
File Interpreter ABI Platform
us_water_quality_data-2026.10.23-py3-none-any.whl Python 3 none any Details

Total release size: 12.5 MB

Release files / us_water_quality_data-2026.10.23.tar.gz

Download URL us_water_quality_data-2026.10.23.tar.gz
Size 6.3 MB
Tags Source
SHA-256 checksum
How to use checksums
d8d602f62f1e46f1c89d1bdd3b21b9bb2536468521ccea1720e5bf4f78d53ba9
BLAKE2b-256 checksum
How to use checksums
4c536823f3e5fa18c8e2222278201f0fa4ee8135c09bd4b6dbe4963b4f660fb3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.11.15

Release files / us_water_quality_data-2026.10.23-py3-none-any.whl

Download URL us_water_quality_data-2026.10.23-py3-none-any.whl
Size 6.3 MB
Tags Python 3
SHA-256 checksum
How to use checksums
08f40106ee014ff5488bfe6948748f95b202855a2f206ad3cc86c48296684579
BLAKE2b-256 checksum
How to use checksums
495e732726193bca845ad7e3ba1ba75925fdfb0a776a6232475a1879efe80058
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.11.15

Security for us-water-quality-data 2026.10.23

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

2026.10.23 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page