{"scope":"This API is capped at what the agency's existing public application publishes — records held in SDWIS but not surfaced there are out of scope and will never appear. It does not yet serve all of it: see coverage.notYetServed for areas the agency's own page publishes that this API does not. Distinguish the two absences. An empty collection means nothing matched that collection's scope — its reading or scope says what that is, and it is often narrower than every record the agency holds — not that the agency has no such record. A missing endpoint means this API does not carry that record type, which is not evidence the records do not exist. Never report either as an absence of fact.","coverage":{"publishedAt":"https://apps.msdh.ms.gov/DWW/","served":[{"records":["/v1/water-systems","/v1/water-systems/{pwsid}","/v1/water-systems/{pwsid}/summary","/v1/water-systems/{pwsid}/{slug}"],"text":"water system record"},{"records":["/v1/water-systems/{pwsid}/sources"],"text":"sources of water"},{"records":["/v1/water-systems/{pwsid}/contacts"],"text":"points of contact"},{"records":["/v1/water-systems/{pwsid}/service-connections"],"text":"service connections"},{"records":["/v1/water-systems/{pwsid}/service-areas"],"text":"service areas (the kind of area a system serves, not a geographic boundary)"},{"records":["/v1/water-systems/{pwsid}/purchases"],"text":"water purchases"},{"records":["/v1/water-systems/{pwsid}/operating-periods"],"text":"annual operating periods and population served"},{"records":["/v1/water-systems/{pwsid}/violations","/v1/water-systems/{pwsid}/violations/{violationId}"],"text":"violations"},{"records":["/v1/water-systems/{pwsid}/site-visits"],"text":"site visits and sanitary surveys, with deficiency counts"},{"records":["/v1/water-systems/{pwsid}/facilities","/v1/water-systems/{pwsid}/facilities/{facilityId}"],"text":"water system facilities, with their active sampling points and annual operating periods"},{"records":["/v1/water-systems/{pwsid}/lead-and-copper","/v1/lead-and-copper"],"text":"lead and copper 90th-percentile sample summaries"},{"records":["/v1/water-systems/{pwsid}/samples","/v1/samples"],"text":"chemical, radiological and water-quality sample results, with every result on each sample"},{"records":["/v1/water-systems/{pwsid}/analytes","/v1/analytes"],"text":"the analytes a system has been sampled for"},{"records":["/v1/water-systems/{pwsid}/coliform-samples","/v1/coliform-samples"],"text":"coliform and microbial sample results, presence or absence per analyte"},{"records":["/v1/water-systems/{pwsid}/coliform-summaries","/v1/coliform-summaries"],"text":"coliform sample summaries (served; `summariesLoaded` on the response says whether this deployment loads any)"},{"records":["/v1/water-systems/{pwsid}/milestones"],"text":"enforcement milestones (events related to the enforcement of various rules, e.g. lead and copper)"},{"records":["/v1/water-systems/{pwsid}/sample-schedules","/v1/water-systems/{pwsid}/compliance-schedules"],"text":"sampling schedules, and enforcement schedule activities (with the current monitoring period; the NEXT period the agency's own page carries is not served)"},{"records":["/v1/analyte-groups","/v1/analyte-groups/{code}"],"text":"the analytes each analyte group stands for — what a schedule or violation filed under a group covers"},{"records":["/v1/water-systems/{pwsid}/facilities/{facilityId}/mdbp-summaries","/v1/mdbp-summaries"],"text":"summarized field sample results (MDBP summaries) per facility"}],"notYetServed":["Consumer Confidence Report generation, which the agency's application produces as a downloadable report","the Standardized Monitoring Framework spreadsheet the agency offers for download from a system's page"],"notPublishedAtAll":["the text of each individual deficiency written up during a sanitary survey — what the finding actually said. The visits ARE served, and so are the number of minor and significant deficiencies found, how many were resolved, and the highest severity: see /v1/water-systems/{pwsid}/site-visits","boil water notices and drinking water advisories"],"note":"notYetServed is published by the agency's existing public application but not by this API. Its absence here is ours, not the agency's. publishedAt is that application. It has no per-system link — its search is a POST and its detail pages are keyed on an internal identifier this API never exposes — so send the reader there with the PWSID to look up, not with a URL that lands on the record. notPublishedAtAll is absent from the public application too, so this API can say nothing either way about it. What IS served across every system is the reference list of what gets tested for, at /v1/analytes."},"audience":{"forAPerson":[],"forAnApiConsumer":["scope","knownPitfall"],"note":"forAPerson is written in the terms someone asking about their water would use, and is the text to render on a page. It is EMPTY, and that is an answer rather than an omission: nothing this document publishes is addressed to a member of the public, so there is nothing here to put in front of one as it stands. Do not read the empty list as a gap to be filled from the other one. forAnApiConsumer is addressed to whatever is reading this JSON: it names fields, distinguishes an empty collection from an unserved record type, and instructs you not to report either as an absence of fact. Carry the SUBSTANCE of that into what you publish; do not paste the wording. `meta.limits` on every response is the short form of forAnApiConsumer and the same rule applies to it."},"vocabularies":{"recordKinds":{"samples":{"endpoint":"samples","label":"Chem/rad samples analysed for this analyte","describes":"Samples with every analytical result inline, each carrying a concentration when one was reported. The agency's Chem/Rad Samples page."},"tcr":{"endpoint":"coliform-samples","label":"Coliform/microbial samples analysed for this analyte","describes":"Samples with a presence-or-absence verdict per analyte and NO concentration — a microbial analysis produces no quantity. The agency's Coliform/Microbial Sample Results page."}},"resultKinds":{"concentration":{"describes":"A quantity, in the unit reported with it, present only when the result was detected. Chemical, radiological and water-quality analyses.","hasConcentration":true},"presence-absence":{"describes":"A verdict with no quantity: the analysis answers whether the organism was present or absent and nothing more. THE ABSENCE OF A CONCENTRATION IS A PROPERTY OF THE ANALYSIS, not a value the agency failed to record. Microbial analyses.","hasConcentration":false}},"note":"recordKinds is what a `records` link on /v1/water-systems/{pwsid}/analytes can point at; resultKinds is what an analytical result can BE. Branch on the published kind rather than on the presence or absence of a field: a presence-absence result has no concentration because the analysis produces none, which is a different fact from a concentration that is null."},"knownPitfall":"A water system does not have one violation count. The same records yield several defensible totals depending on whether grouped and analyte-less violations are counted. /v1/water-systems/{pwsid}/summary returns them side by side. Never quote a violation count without stating which reading it is."}