curl -X POST https://win.oneshotagent.com/v1/tools/lookup/place-drinking-water \
-H "Content-Type: application/json" \
-H "payment-signature: <base64 x402 payment>" \
-d '{
"county_fips": "26049",
"limit": 3
}'
const response = await fetch("https://win.oneshotagent.com/v1/tools/lookup/place-drinking-water", {
method: "POST",
headers: {
"Content-Type": "application/json",
"payment-signature": paymentProof,
},
body: JSON.stringify({
"county_fips": "26049",
"limit": 3
}),
});
const result = await agent.tool('lookup/place-drinking-water', {
county_fips: '26049',
limit: 3
});
console.log(result.result);
console.log(result.evidence);
{
"success": true,
"data": {
"request_id": "uuid",
"receipt_id": "rcpt_...",
"status": "completed",
"tool": "place_drinking_water",
"result": {
"total_systems": 45,
"enforcement_priority_systems": 2,
"systems_in_violation_now": 11,
"systems_with_violations_3yr": 32,
"systems": [
{
"pwsid": "MI0002310",
"name": "FLINT, CITY OF",
"state": "MI",
"counties_served": "Genesee",
"cities_served": "FLINT",
"registry_id": "110013122281",
"type": "Community water system",
"primary_source": "Surface water purchased",
"owner_type": "Local government",
"population_served": 81252,
"active": true,
"enforcement_priority": false,
"quarters_in_violation": 2,
"quarters_as_enforcement_priority": 0,
"health_based_violation": false,
"monitoring_violation": false,
"public_notice_violation": false,
"other_violation": false,
"rules_violated_3yr": 1,
"rules_violated_now": 0,
"violation_points_5yr": 5,
"uncorrected_violation_points": 0,
"violation_categories": [
"Treatment Technique Violation"
],
"contaminants_in_violation_3yr": [],
"contaminants_in_violation_now": [],
"lead_action_level_exceedances_5yr": null,
"copper_action_level_exceedances_5yr": null,
"significant_deficiencies_5yr": 5,
"last_formal_action_on": "2016-11-17",
"last_site_visit_on": "2026-01-21"
},
{
"pwsid": "MI0002615",
"name": "GENESEE COUNTY WATER SYSTEM",
"state": "MI",
"counties_served": "Genesee",
"cities_served": null,
"registry_id": "110013123173",
"type": "Community water system",
"primary_source": "Surface water purchased",
"owner_type": "Local government",
"population_served": 73726,
"active": true,
"enforcement_priority": false,
"quarters_in_violation": 0,
"quarters_as_enforcement_priority": 0,
"health_based_violation": false,
"monitoring_violation": false,
"public_notice_violation": false,
"other_violation": false,
"rules_violated_3yr": 0,
"rules_violated_now": 0,
"violation_points_5yr": 1,
"uncorrected_violation_points": 0,
"violation_categories": [],
"contaminants_in_violation_3yr": [],
"contaminants_in_violation_now": [],
"lead_action_level_exceedances_5yr": null,
"copper_action_level_exceedances_5yr": null,
"significant_deficiencies_5yr": null,
"last_formal_action_on": null,
"last_site_visit_on": "2026-01-27"
},
{
"pwsid": "MI0001010",
"name": "BURTON, CITY OF",
"state": "MI",
"counties_served": "Genesee",
"cities_served": "BURTON",
"registry_id": "110013129738",
"type": "Community water system",
"primary_source": "Surface water purchased",
"owner_type": "Local government",
"population_served": 21000,
"active": true,
"enforcement_priority": false,
"quarters_in_violation": 2,
"quarters_as_enforcement_priority": 0,
"health_based_violation": false,
"monitoring_violation": false,
"public_notice_violation": false,
"other_violation": false,
"rules_violated_3yr": 1,
"rules_violated_now": 0,
"violation_points_5yr": 6,
"uncorrected_violation_points": 5,
"violation_categories": [
"Treatment Technique Violation"
],
"contaminants_in_violation_3yr": [
{
"code": "5000",
"name": "Lead and Copper Rule"
}
],
"contaminants_in_violation_now": [
{
"code": "5000",
"name": "Lead and Copper Rule"
}
],
"lead_action_level_exceedances_5yr": null,
"copper_action_level_exceedances_5yr": null,
"significant_deficiencies_5yr": null,
"last_formal_action_on": null,
"last_site_visit_on": "2024-08-07"
}
]
},
"evidence": {
"source": "US Environmental Protection Agency",
"source_kind": "public",
"retrieved_at": "2026-10-26T12:00:00.000Z",
"calls": [
{
"retrieved_at": "2026-10-26T12:00:00.000Z"
},
{
"retrieved_at": "2026-10-26T12:00:00.000Z"
}
],
"as_of": null
}
}
}
Places & hazards
Drinking Water
Find public water systems serving a county and their drinking water violations, largest population first.
POST
/
v1
/
tools
/
lookup
/
place-drinking-water
curl -X POST https://win.oneshotagent.com/v1/tools/lookup/place-drinking-water \
-H "Content-Type: application/json" \
-H "payment-signature: <base64 x402 payment>" \
-d '{
"county_fips": "26049",
"limit": 3
}'
const response = await fetch("https://win.oneshotagent.com/v1/tools/lookup/place-drinking-water", {
method: "POST",
headers: {
"Content-Type": "application/json",
"payment-signature": paymentProof,
},
body: JSON.stringify({
"county_fips": "26049",
"limit": 3
}),
});
const result = await agent.tool('lookup/place-drinking-water', {
county_fips: '26049',
limit: 3
});
console.log(result.result);
console.log(result.evidence);
{
"success": true,
"data": {
"request_id": "uuid",
"receipt_id": "rcpt_...",
"status": "completed",
"tool": "place_drinking_water",
"result": {
"total_systems": 45,
"enforcement_priority_systems": 2,
"systems_in_violation_now": 11,
"systems_with_violations_3yr": 32,
"systems": [
{
"pwsid": "MI0002310",
"name": "FLINT, CITY OF",
"state": "MI",
"counties_served": "Genesee",
"cities_served": "FLINT",
"registry_id": "110013122281",
"type": "Community water system",
"primary_source": "Surface water purchased",
"owner_type": "Local government",
"population_served": 81252,
"active": true,
"enforcement_priority": false,
"quarters_in_violation": 2,
"quarters_as_enforcement_priority": 0,
"health_based_violation": false,
"monitoring_violation": false,
"public_notice_violation": false,
"other_violation": false,
"rules_violated_3yr": 1,
"rules_violated_now": 0,
"violation_points_5yr": 5,
"uncorrected_violation_points": 0,
"violation_categories": [
"Treatment Technique Violation"
],
"contaminants_in_violation_3yr": [],
"contaminants_in_violation_now": [],
"lead_action_level_exceedances_5yr": null,
"copper_action_level_exceedances_5yr": null,
"significant_deficiencies_5yr": 5,
"last_formal_action_on": "2016-11-17",
"last_site_visit_on": "2026-01-21"
},
{
"pwsid": "MI0002615",
"name": "GENESEE COUNTY WATER SYSTEM",
"state": "MI",
"counties_served": "Genesee",
"cities_served": null,
"registry_id": "110013123173",
"type": "Community water system",
"primary_source": "Surface water purchased",
"owner_type": "Local government",
"population_served": 73726,
"active": true,
"enforcement_priority": false,
"quarters_in_violation": 0,
"quarters_as_enforcement_priority": 0,
"health_based_violation": false,
"monitoring_violation": false,
"public_notice_violation": false,
"other_violation": false,
"rules_violated_3yr": 0,
"rules_violated_now": 0,
"violation_points_5yr": 1,
"uncorrected_violation_points": 0,
"violation_categories": [],
"contaminants_in_violation_3yr": [],
"contaminants_in_violation_now": [],
"lead_action_level_exceedances_5yr": null,
"copper_action_level_exceedances_5yr": null,
"significant_deficiencies_5yr": null,
"last_formal_action_on": null,
"last_site_visit_on": "2026-01-27"
},
{
"pwsid": "MI0001010",
"name": "BURTON, CITY OF",
"state": "MI",
"counties_served": "Genesee",
"cities_served": "BURTON",
"registry_id": "110013129738",
"type": "Community water system",
"primary_source": "Surface water purchased",
"owner_type": "Local government",
"population_served": 21000,
"active": true,
"enforcement_priority": false,
"quarters_in_violation": 2,
"quarters_as_enforcement_priority": 0,
"health_based_violation": false,
"monitoring_violation": false,
"public_notice_violation": false,
"other_violation": false,
"rules_violated_3yr": 1,
"rules_violated_now": 0,
"violation_points_5yr": 6,
"uncorrected_violation_points": 5,
"violation_categories": [
"Treatment Technique Violation"
],
"contaminants_in_violation_3yr": [
{
"code": "5000",
"name": "Lead and Copper Rule"
}
],
"contaminants_in_violation_now": [
{
"code": "5000",
"name": "Lead and Copper Rule"
}
],
"lead_action_level_exceedances_5yr": null,
"copper_action_level_exceedances_5yr": null,
"significant_deficiencies_5yr": null,
"last_formal_action_on": null,
"last_site_visit_on": "2024-08-07"
}
]
},
"evidence": {
"source": "US Environmental Protection Agency",
"source_kind": "public",
"retrieved_at": "2026-10-26T12:00:00.000Z",
"calls": [
{
"retrieved_at": "2026-10-26T12:00:00.000Z"
},
{
"retrieved_at": "2026-10-26T12:00:00.000Z"
}
],
"as_of": null
}
}
}
Returns public water systems serving a US county and their drinking water compliance records from the US Environmental Protection Agency, largest population first. Includes enforcement priority, violation categories, contaminants and inspection dates. Reports follow quarterly state submissions and can lag by three to six months.
Authentication
Requires x402 payment in thepayment-signature header.
Request Body
string
required
Five-digit state plus county code, the county_id returned by Place Resolve (place_resolve), for example 26049 for Genesee County, Michigan.
string
Community serves residents year round; non-transient non-community includes schools and workplaces; transient non-community includes rest stops and restaurants; all includes every type. One of
community, non_transient_non_community, transient_non_community, all. Defaults to "community".boolean
Include inactive systems as well as active systems. Defaults to
false.integer
How many systems to return, largest population first. From 1 to 25. Defaults to
10.Response (200 OK)
Top-level envelope:success (boolean) and data (object). All fields below are nested under data.
string
Durable job ID for audit and lookup
string
Job status:
completedstring
Always
place_drinking_waterobject
The answer, described under Result below
object
Where the answer came from and when
string
The public body the data comes from. Always
US Environmental Protection Agency.string
public when the data comes from a public body, commercial otherwisestring
When the lookup was made, as an ISO 8601 UTC time
string | null
When the source says the fact was last updated, or
null when the source gives no dateResult
Nested underdata.result.
number
Every matched system, including any beyond limit.
number
Matched systems designated enforcement priorities.
number
Matched systems currently in violation.
number
Matched systems with violations in the last three years.
object[]
Matching systems, largest population served first, at most limit.
string
Public water system identifier.
string | null
System name as recorded.
null when the source gives no value.string | null
Two-letter state code.
null when the source gives no value.string | null
Counties served, as recorded.
null when the source gives no value.string | null
Cities served, as recorded; some states leave this blank.
null when the source gives no value.string | null
The identifier the source gives the facility across every program.
null when the source gives no value.string | null
Public water system type description.
null when the source gives no value.string | null
Primary water source description.
null when the source gives no value.string | null
Owner type description.
null when the source gives no value.integer | null
The estimated average daily population served by a system.
null when the source gives no value.boolean
True when the source activity code is A (active).
boolean | null
True indicates a public water system with unresolved serious, multiple, and/or continuing violations, a priority candidate for formal enforcement.
null when the source gives no value.integer | null
How many of the last twelve quarters the system was in violation.
null when the source gives no value.integer | null
How many of the last twelve quarters the system was an enforcement priority.
null when the source gives no value.boolean | null
Violations of maximum contaminant levels, maximum residual disinfectant levels or treatment technique rules flagged in the source’s current compliance summary.
null when the source gives no value.boolean | null
Failure to monitor or report flagged in the source’s current compliance summary.
null when the source gives no value.boolean | null
Public notification requirements violations flagged in the source’s current compliance summary.
null when the source gives no value.boolean | null
Other violations, for example consumer confidence reports or records, flagged in the source’s current compliance summary.
null when the source gives no value.integer | null
Rules violated in the last three years.
null when the source gives no value.integer | null
Rules violated as of the latest official quarter.
null when the source gives no value.integer | null
Violation points accrued over the last five years.
null when the source gives no value.integer | null
Violation points remaining uncorrected.
null when the source gives no value.string[]
Violation categories recorded for the system.
object[]
Contaminants or rules in violation in the last three years.
string
Code.
string
Name.
object[]
Contaminants or rules in violation as of the latest official quarter.
string
Code.
string
Name.
integer | null
Lead action level exceedances in the last five years: 90th percentile over 0.015 mg/L.
null when the source gives no value.integer | null
Copper action level exceedances in the last five years: 90th percentile over 1.3 mg/L.
null when the source gives no value.integer | null
Significant deficiencies from sanitary surveys in the last five years.
null when the source gives no value.string | null
Most recent formal enforcement action date, YYYY-MM-DD.
null when the source gives no value.string | null
Most recent site visit date, YYYY-MM-DD.
null when the source gives no value.curl -X POST https://win.oneshotagent.com/v1/tools/lookup/place-drinking-water \
-H "Content-Type: application/json" \
-H "payment-signature: <base64 x402 payment>" \
-d '{
"county_fips": "26049",
"limit": 3
}'
const response = await fetch("https://win.oneshotagent.com/v1/tools/lookup/place-drinking-water", {
method: "POST",
headers: {
"Content-Type": "application/json",
"payment-signature": paymentProof,
},
body: JSON.stringify({
"county_fips": "26049",
"limit": 3
}),
});
const result = await agent.tool('lookup/place-drinking-water', {
county_fips: '26049',
limit: 3
});
console.log(result.result);
console.log(result.evidence);
{
"success": true,
"data": {
"request_id": "uuid",
"receipt_id": "rcpt_...",
"status": "completed",
"tool": "place_drinking_water",
"result": {
"total_systems": 45,
"enforcement_priority_systems": 2,
"systems_in_violation_now": 11,
"systems_with_violations_3yr": 32,
"systems": [
{
"pwsid": "MI0002310",
"name": "FLINT, CITY OF",
"state": "MI",
"counties_served": "Genesee",
"cities_served": "FLINT",
"registry_id": "110013122281",
"type": "Community water system",
"primary_source": "Surface water purchased",
"owner_type": "Local government",
"population_served": 81252,
"active": true,
"enforcement_priority": false,
"quarters_in_violation": 2,
"quarters_as_enforcement_priority": 0,
"health_based_violation": false,
"monitoring_violation": false,
"public_notice_violation": false,
"other_violation": false,
"rules_violated_3yr": 1,
"rules_violated_now": 0,
"violation_points_5yr": 5,
"uncorrected_violation_points": 0,
"violation_categories": [
"Treatment Technique Violation"
],
"contaminants_in_violation_3yr": [],
"contaminants_in_violation_now": [],
"lead_action_level_exceedances_5yr": null,
"copper_action_level_exceedances_5yr": null,
"significant_deficiencies_5yr": 5,
"last_formal_action_on": "2016-11-17",
"last_site_visit_on": "2026-01-21"
},
{
"pwsid": "MI0002615",
"name": "GENESEE COUNTY WATER SYSTEM",
"state": "MI",
"counties_served": "Genesee",
"cities_served": null,
"registry_id": "110013123173",
"type": "Community water system",
"primary_source": "Surface water purchased",
"owner_type": "Local government",
"population_served": 73726,
"active": true,
"enforcement_priority": false,
"quarters_in_violation": 0,
"quarters_as_enforcement_priority": 0,
"health_based_violation": false,
"monitoring_violation": false,
"public_notice_violation": false,
"other_violation": false,
"rules_violated_3yr": 0,
"rules_violated_now": 0,
"violation_points_5yr": 1,
"uncorrected_violation_points": 0,
"violation_categories": [],
"contaminants_in_violation_3yr": [],
"contaminants_in_violation_now": [],
"lead_action_level_exceedances_5yr": null,
"copper_action_level_exceedances_5yr": null,
"significant_deficiencies_5yr": null,
"last_formal_action_on": null,
"last_site_visit_on": "2026-01-27"
},
{
"pwsid": "MI0001010",
"name": "BURTON, CITY OF",
"state": "MI",
"counties_served": "Genesee",
"cities_served": "BURTON",
"registry_id": "110013129738",
"type": "Community water system",
"primary_source": "Surface water purchased",
"owner_type": "Local government",
"population_served": 21000,
"active": true,
"enforcement_priority": false,
"quarters_in_violation": 2,
"quarters_as_enforcement_priority": 0,
"health_based_violation": false,
"monitoring_violation": false,
"public_notice_violation": false,
"other_violation": false,
"rules_violated_3yr": 1,
"rules_violated_now": 0,
"violation_points_5yr": 6,
"uncorrected_violation_points": 5,
"violation_categories": [
"Treatment Technique Violation"
],
"contaminants_in_violation_3yr": [
{
"code": "5000",
"name": "Lead and Copper Rule"
}
],
"contaminants_in_violation_now": [
{
"code": "5000",
"name": "Lead and Copper Rule"
}
],
"lead_action_level_exceedances_5yr": null,
"copper_action_level_exceedances_5yr": null,
"significant_deficiencies_5yr": null,
"last_formal_action_on": null,
"last_site_visit_on": "2024-08-07"
}
]
},
"evidence": {
"source": "US Environmental Protection Agency",
"source_kind": "public",
"retrieved_at": "2026-10-26T12:00:00.000Z",
"calls": [
{
"retrieved_at": "2026-10-26T12:00:00.000Z"
},
{
"retrieved_at": "2026-10-26T12:00:00.000Z"
}
],
"as_of": null
}
}
}
See Pricing for this tool’s price. A wallet (x402) call receives it in the 402 quote before anything is charged; a call paid from prepaid credits is charged when the API accepts the request and answers
200.Notes
- Data follow state reports quarterly and can lag by three to six months. Counts describe the latest official quarter or the stated three- or five-year period, with no source history.
- A system is listed for every county it serves, so a large utility can appear under several counties.
- The counts cover every matched system, not only those returned. The list has at most
limitsystems, largest population served first. - By default, only active community systems serving residents year round are included. Use
system_type: allfor schools, workplaces and rest stops with their own wells; useinclude_inactive: trueto include inactive systems. - Results return inline. The finished job stays available at
/v1/requests/{request_id}