{
 "built": "2026-11-19",
 "sources": [
  {
   "state": "ALL",
   "dataset": "USGS: Estimated county level domestic well population with arsenic > 10 \u00b5g/L (Ayotte, Medalie & Qi, 2017)",
   "url": "https://doi.org/10.5066/F7CN724V",
   "records": 3138,
   "file_sha256_16": "393a2e0fc2e2c6bd"
  },
  {
   "state": "MN",
   "dataset": "Minnesota County Well Index (MGS/MDH), non-public-supply wells",
   "url": "https://cse.umn.edu/mgs/cwi",
   "filter": "USE_C = 'DO' (domestic)",
   "records": 576453,
   "file_sha256_16": "898f44acf61b50da"
  },
  {
   "state": "MI",
   "dataset": "Michigan EGLE Wellogic water wells",
   "url": "https://gis-egle.hub.arcgis.com/datasets/egle::michigan-wellogic-wells/about",
   "filter": "WELL_TYPE = 'HOSHLD' (household)",
   "records": 1084120,
   "file_sha256_16": "ce2d7e096b1c1238"
  },
  {
   "state": "CA",
   "dataset": "California DWR Well Completion Reports (OSWCR)",
   "url": "https://data.cnra.ca.gov/dataset/well-completion-reports",
   "filter": "Planned use 'Water Supply Domestic', record type 'New'",
   "records": 377705,
   "file_sha256_16": "2604f8e732af95b6"
  },
  {
   "state": "WA",
   "dataset": "Well Construction Reports (Well Log Database), Washington Department of Ecology",
   "fetched_at": "2026-11-18T19:34:20+00:00",
   "url": "https://services.arcgis.com/6lCKYNJLvwTXqrmp/arcgis/rest/services/WR/FeatureServer/9",
   "filter": "WellProjectType='Water' and WellSubType in ('Water (Cased)','Water (Dug)') (water-supply wells; no domestic-only field exists)",
   "records": 165233,
   "caveats": [
    "Ecology Well Construction Reports has no use field separating domestic from irrigation/municipal/commercial water wells; all new water-supply wells (WellProjectType Water) are included, the large majority are single-household exempt wells",
    "CompletedDepth and StaticWaterLvl are stored as text and converted to numbers (feet); zero depths ignored",
    "Water Sampling, Resource Protection, Geotechnical, Dewatering, Ground Source, Decommissioning records excluded"
   ]
  },
  {
   "state": "ME",
   "dataset": "Maine Well Database (Maine Geological Survey, Dept. of Agriculture, Conservation & Forestry)",
   "fetched_at": "2026-11-18T19:35:46+00:00",
   "url": "https://services1.arcgis.com/RbMX0mRVOFNTdLzd/ArcGIS/rest/services/MGS_Wells_Database/FeatureServer/0",
   "filter": "WELL_USE in ('DOMESTIC','FARM, DOMESTIC'), geothermal and observation excluded",
   "records": 92816,
   "caveats": [
    "Maine Well Database holds domestic wells reported by drillers; ~40% have coordinates but all records carry a town, so all are used",
    "County derived from WELL_LOCATION_TOWN via Census 2020 county subdivisions; unmapped towns go to (unknown)",
    "Depth = WELL_DEPTH_FT; yield = WELL_YIELD_GPM; static = WELL_STATIC_LEVEL_FT (sparse)",
    "Mostly bedrock wells (WELL_TYPE BEDROCK ~96%); includes some gravel/overburden/dug"
   ]
  },
  {
   "state": "IA",
   "dataset": "Private Well Tracking System (Private Well Facilities layer), Iowa Department of Natural Resources",
   "fetched_at": "2026-11-18T19:38:17+00:00",
   "url": "https://programs.iowadnr.gov/geospatial/rest/services/OneStop/QueryEnvFacs/MapServer/22",
   "filter": "No use field: layer is the Iowa DNR Private Well Tracking System (private wells = household supply wells); all opStatus values included",
   "records": 41504,
   "caveats": [
    "Private Well Tracking System has no use field; it tracks private (non-public) water supply wells, mostly household, some may be livestock/ag",
    "No static water level or yield fields in this layer",
    "Includes all opStatus values (Active, Expired, Retired, Plugged ...); n_records is deduped on progid",
    "PWTS records mainly from ~1990s onward (state well-program permits), so pre-1990 stats are thin"
   ]
  },
  {
   "state": "AR",
   "dataset": "Arkansas Water Well Construction Database (public layer), Arkansas Department of Agriculture - Natural Resources Division",
   "fetched_at": "2026-11-18T19:28:39+00:00",
   "url": "https://adaesri.aad.arkansas.gov/server/rest/services/Hosted/WaterwellConstructionDatabasePublic/FeatureServer/22",
   "filter": "use_cd_x='DO' (Domestic use code in Arkansas Water Well Construction Database)",
   "records": 31436,
   "caveats": [
    "county_cd_x is the 3-digit county FIPS code, mapped to Census names",
    "Layer is the public Waterwell Construction Database (Arkansas Dept. of Agriculture Natural Resources Division, formerly ANRC/AAD); ~96k records total, skewed to eastern-Arkansas irrigation",
    "Includes all well_status_x values (new wells, repairs etc.)"
   ]
  },
  {
   "state": "FL",
   "dataset": "Well completion report sites (delegated counties + District issued permits), St. Johns River Water Management District (SJRWMD), Florida",
   "fetched_at": "2026-11-18T19:31:54+00:00",
   "url": "https://services.arcgis.com/s8wtJX9suxFen6TA/arcgis/rest/services/Well_completion_report_sites_delegated_counties/FeatureServer/0",
   "filter": "WELL_USE='Domestic' (SJRWMD well completion report sites; delegated-county + district-issued permit layers merged, deduped on STN_ID)",
   "records": 132426,
   "caveats": [
    "Coverage is only the SJRWMD-area and delegated-county well completion reports (about 20 counties heavy in NE/central/east FL); SWFWMD, SFWMD, SRWMD, NWFWMD not included unless noted in the report",
    "No yield field in layer",
    "Depth = WELL_CUR_DPTH (current well depth), not casing depth",
    "Static level of 0 treated as missing",
    "Use 'Domestic' only; Irrigation, Monitoring, Public Supply, HVAC excluded"
   ]
  },
  {
   "state": "MA",
   "dataset": "MassDEP Well Driller Program well completion reports (Well Location Viewer data, snapshot 26 Apr 2023)",
   "fetched_at": "2026-11-18T19:44:06+00:00",
   "url": "https://services1.arcgis.com/7iJyYTjCtKsZS1LR/arcgis/rest/services/Well_Location_Viewer_Data_4_26_23/FeatureServer/0",
   "filter": "Well_Type='Domestic', Work_Performed<>'Decommission', no Error_Flag",
   "records": 78066,
   "caveats": [
    "Layer is MassDEP's published 'Well Location Viewer' extract (127,011 of ~206,000 reports; only reports with parcel-level verified location)",
    "Snapshot dated 2023-04-26, so recent wells are missing; hosted on ArcGIS Online by MassDEP (DEP_DWP)",
    "Fields are strings in source, parsed numerically; zero treated as missing",
    "County derived from Town via Census 2020 county subdivisions"
   ]
  },
  {
   "state": "VA",
   "dataset": "Virginia Water Wells (VA_Water_Wells), Virginia Department of Energy, Division of Geology and Mineral Resources (compiled from DEQ GW-2, VDH, USGS, WWCR records)",
   "fetched_at": "2026-11-18T19:34:42+00:00",
   "url": "https://energy.virginia.gov/gis/rest/services/DGMR/VA_Water_Wells/MapServer/0",
   "filter": "Function_='Domestic' (exact; excludes 'Industrial and Domestic', Farm, Public, Municipal etc.; Use_ free-text ignored)",
   "records": 7530,
   "caveats": [
    "Static level 0, yield 0 and depth 0 are treated as missing (source uses 0 for unknown)",
    "Many records have no completion date (era splits sparse)",
    "Independent cities appear as 'Name (City)' which normalises to the Census 'Name city'; 'Fairfax', 'Roanoke', 'Richmond', 'Franklin', 'Bedford' county vs city cannot be separated",
    "Spotsylvania median depth 28 ft looks suspicious (likely shallow/old dug or unit-mixed records) - flag",
    "Compiled historic data; not complete for all VA wells; Virginia only requires well reports since 1992 (DEQ GWMA/WWCR)"
   ]
  },
  {
   "state": "IN",
   "dataset": "IN DNR Water Well Records (Water Well Record Database), Indiana Department of Natural Resources, Division of Water",
   "fetched_at": "2026-11-18T19:39:11+00:00",
   "url": "https://gisdata.in.gov/server/rest/services/Hosted/WaterWells_DNR_Water_IN_1/FeatureServer/0",
   "filter": "NO use field in the Indiana DNR record layer; heuristic residential proxy: owner name has no business/utility/government/institution keyword, casing diameter <= 6 in (or missing), pump rate <= 100 gpm (or missing)",
   "records": 347191,
   "caveats": [
    "Indiana DNR Division of Water Well Record Database (IN DNR Water Well Records) has no well-use field; domestic wells are inferred, not labelled. Medians describe 'small-diameter wells owned by what look like individuals', including some small irrigation, agricultural, and geothermal wells",
    "Owner fields used only server-side for filtering; not stored in output",
    "Zero in depth/static/yield means missing and is ignored; many old records have completion-date year placeholders"
   ]
  },
  {
   "state": "OK",
   "dataset": "Oklahoma Water Resources Board groundwater well records",
   "fetched_at": "2026-11-18T19:28:26+00:00",
   "url": "https://owrb.csa.ou.edu/server/rest/services/Groundwater/Groundwater_Wells/MapServer/1",
   "filter": "use_class='Domestic'",
   "records": 93587,
   "caveats": []
  },
  {
   "state": "ND",
   "dataset": "Water Resource Sites database (ground-water site inventory, domestic wells), North Dakota Department of Water Resources (formerly State Water Commission)",
   "fetched_at": "2026-11-18T19:40:38+00:00",
   "url": "https://www.dwr.nd.gov/info_edu/map_data_resources/waterresourcesites/index.html",
   "filter": "Purpose='Domestic Well' (Water Resource Sites inventory, site download sites.txt; MN-/MT- out-of-state sites dropped)",
   "records": 5021,
   "caveats": [
    "Not the full drillers-log file: DWR's public site inventory holds only ~5.5k domestic wells statewide (ND has far more drilled), so coverage is partial and skewed to cooperative USGS/DWR county ground-water studies",
    "Depth = Total_Depth, falling back to Bottom_Screen when Total_Depth is 0/blank (about 30% fallbacks)",
    "No static level or yield columns in the site download; ground-water level measurements are in a separate table not used here",
    "Date_Drilled is often a placeholder like 19xx-01-01 for historic wells"
   ]
  },
  {
   "state": "PA",
   "dataset": "Pennsylvania DCNR PaGWIS water wells",
   "fetched_at": "2026-11-18T19:30:52+00:00",
   "url": "https://services.arcgis.com/CPq7UDkBXVRqtgLR/arcgis/rest/services/PAGWISWaterWells/FeatureServer/0",
   "filter": "Water_Use='DOMESTIC' (layer holds 9 duplicated OID blocks; only first block OID<26713000 read, then deduped on PAWellID)",
   "records": 351531,
   "caveats": []
  },
  {
   "state": "MO",
   "dataset": "Water Wells (Wellhead Information Management System, certified water wells), Missouri Department of Natural Resources - Missouri Geological Survey",
   "fetched_at": "2026-11-18T19:42:38+00:00",
   "url": "https://gis.dnr.mo.gov/host/rest/services/geology/water_wells/MapServer/1 (Missouri DNR 'Water Wells' open-data layer, GIS Hub CSV export)",
   "filter": "WELL_TYPE='Domestic' (WIMS well types: Domestic, High Yield, Public, Multi-Family)",
   "records": 172835,
   "caveats": [
    "Layer has no county field: county assigned by point-in-polygon of the well point against US Census TIGERweb 2020s county polygons (simplified 0.0005 deg); 51 domestic wells not located in a county were dropped",
    "gis.dnr.mo.gov REST endpoint is behind a bot-blocking firewall for scripted queries, so data pulled via the official ArcGIS Hub CSV export (gis-modnr.opendata.arcgis.com, item 7ec0b65d9c184f8b9af996b4fe554203)",
    "Many well points are placed at PLSS section centers (location accuracy varies) so county can be wrong for wells near a county line",
    "Depth = TOTAL_DPTH; static = SWL (feet); yield = WELL_YIELD (driller-reported GPM); WIMS holds drillers' certified wells (required since 1985 Water Well Drillers law); all rows are WELL_STAT Active",
    "Independent city of St. Louis is kept as its own unit ('St. Louis city')"
   ]
  },
  {
   "state": "SD",
   "dataset": "NR68 Water Well Completion Reports (well logs, public layer), South Dakota Department of Agriculture and Natural Resources - Water Rights Program",
   "fetched_at": "2026-11-18T19:45:01+00:00",
   "url": "https://sdgis.sd.gov/danr/rest/services/BIT_Systems/NR68_WellLogs_Public/MapServer/0",
   "filter": "WELL_TYPE='DOM' (Domestic)",
   "records": 38031,
   "caveats": [
    "Oglala Lakota County (FIPS 46102) renamed Shannon to match the Census file in data/raw/census (FIPS 46113 era name)",
    "Static level kept only where staticType='depth' (pressure/flowing readings dropped); only ~10% of logs carry a static value",
    "No yield field in the public layer",
    "Well logs required since 1975; some older reports included",
    "Includes domestic wells of all statuses in the public layer (plugged wells use separate type PLG and are excluded)"
   ]
  },
  {
   "state": "MT",
   "dataset": "Ground Water Information Center (GWIC) database, Montana Bureau of Mines and Geology (Montana Tech)",
   "fetched_at": "2026-11-18T19:45:27+00:00",
   "url": "https://mbmgmap.mtech.edu/server/rest/services/Water_Resources/GWIC_Database/FeatureServer",
   "filter": "GWIC Well Use layer well_use='DOMESTIC' AND priority=1 (primary use), joined on gwicid to Boreholes site_type='WELL'",
   "records": 182113,
   "caveats": [
    "GWIC is split into relational layers; Boreholes joined to Well Use and Performance on gwicid",
    "County names are upper-case in source and title-cased here",
    "Includes all domestic wells with a GWIC record, including older and abandoned/dry-hole records (site_type WELL)",
    "Depths and levels are feet below ground surface"
   ]
  },
  {
   "state": "ID",
   "dataset": "Wells (well driller's reports), Idaho Department of Water Resources",
   "fetched_at": "2026-11-18T19:42:29+00:00",
   "url": "https://gis.idwr.idaho.gov/hosting/rest/services/Groundwater/Wells/FeatureServer/0",
   "filter": "WellUse in Domestic, Domestic-Single Residence, Domestic-Multiple Residence, Domestic-Multiple Individual Users, Domestic-Livestock (excludes Domestic-Public Water Supply; 54% of records have blank WellUse and are excluded)",
   "records": 81193,
   "caveats": [
    "54% of IDWR well records (mostly older reports) have a blank WellUse and are excluded, so counts understate domestic wells and skew toward newer wells",
    "Records are from the database that holds most reports since July 1987; older ones are less complete",
    "Depth/static values of 9999 and static level 0 treated as missing; units feet",
    "ProductionRate taken as yield gpm",
    "Out-of-state county labels (Cache UT, Mineral MT etc.) kept as tiny rows"
   ]
  },
  {
   "state": "NE",
   "dataset": "Registered Groundwater Wells (Groundwater Wells DWEE), Nebraska Department of Water, Energy and Environment (formerly DNR)",
   "fetched_at": "2026-11-18T19:36:59+00:00",
   "url": "https://www.nebraskamap.gov/datasets/nebraska::groundwater-wells-dwee (ArcGIS Hub CSV export of item a50ccf265ab94efb8f7b2e809992ee2a; service gis.ne.gov/agency3/rest/services/Groundwater_Wells_DWEE/FeatureServer/0)",
   "filter": "WellUseDescription='Domestic'",
   "records": 48098,
   "caveats": [
    "gis.ne.gov unreachable from the build host; data pulled via the official ArcGIS Hub CSV download of the same layer (export dated 2026-11-17)",
    "Registration required only since 1993-09-09; pre-1993 domestic wells are under-represented (and only registered if later reported)",
    "Includes all Status values (active, inactive, decommissioned)",
    "Depth = TotalDepth; static = StaticWaterLevel; yield = PumpRate (registered pump rate GPM, not a tested yield)"
   ]
  },
  {
   "state": "AL",
   "dataset": "Water Wells (RBDMS-ENV water well database), Geological Survey of Alabama",
   "fetched_at": "2026-11-18T19:43:29+00:00",
   "url": "https://map.gsa.state.al.us/arcgis/rest/services/ALEnv/ALEnvRBDMS/MapServer/5",
   "filter": "FacilityType='Domestic' (case-insensitive) in GSA RBDMS-ENV Water Wells layer; depth from Construct table (WELL_DEPTH ft), static level / pumping rate / year from each well's earliest WaterLevel record",
   "records": 30657,
   "caveats": [
    "GSA says the public RBDMS-ENV data are incomplete vs ~100k hardcopy records on file",
    "No construction-date field: era splits use year of each well's earliest water-level measurement, usually the driller's log (source DL), so it approximates completion year",
    "Only wells with a Construct row have depth; static level is earliest recorded level, not an average"
   ]
  },
  {
   "state": "VT",
   "dataset": "Private Wells / Well Completion Reports (Vermont DEC Drinking Water & Groundwater Protection Division, ANR; via VCGI open data)",
   "fetched_at": "2026-11-18T19:39:11+00:00",
   "url": "https://geodata.vermont.gov/maps/d17192903e80420394b7e8f0405b18a9",
   "filter": "WellUseCode='Domestic', excluding WellReasonCode Geothermal and Test/Exploration/Monitoring",
   "records": 112699,
   "caveats": [
    "Source = Vermont Open Geodata Portal CSV export (data/raw/vt_src/vt_wells.csv); ANR ArcGIS REST host anrmaps.vermont.gov timed out",
    "County derived from Town via Census 2020 county subdivisions",
    "Zero values in depth, yield and static level treated as missing (source uses 0 for unknown)",
    "Reports filed since 1966; many wells never reported"
   ]
  },
  {
   "state": "OR",
   "dataset": "Well Reports (Water Well Log database), Oregon Water Resources Department",
   "fetched_at": "2026-11-18T19:37:06+00:00",
   "url": "https://gis.wrd.state.or.us/server/rest/services/dynamic/Well_Reports_Query_WGS84/FeatureServer/0",
   "filter": "primary_use='Domestic' and type_of_log='Water Well'",
   "records": 286595,
   "caveats": [
    "County field is a 4-letter OWRD code mapped to county names",
    "One location per report (many are PLSS section/quarter-quarter centroids)",
    "Reports include new wells, deepenings, alterations and abandonments; wl_id deduped so versioned reports count once",
    "Static level = post_static_water_level (feet below land surface); depth in feet"
   ]
  },
  {
   "state": "MS",
   "dataset": "MS Water Permit Wells / Water Well Records (Nov 2024), Mississippi DEQ Office of Land and Water Resources, published by MARIS (Mississippi Automated Resource Information System)",
   "fetched_at": "2026-11-18T19:41:23+00:00",
   "url": "https://gis.mississippi.edu/server/rest/services/Hydrology/MS_WaterWells_Nov2024/MapServer/0",
   "filter": "Beneficial='DO' (DOMESTIC (HOME) WELL)",
   "records": 104789,
   "caveats": [
    "Mississippi MDEQ Office of Land and Water Resources water-well permit/driller-log database as published by MARIS (Mississippi Automated Resource Information System, Nov 2024); layer carries total depth, casing diameter, aquifer and use only: no static level, yield or completion date, so those columns and the era splits are blank",
    "Layer does not support resultOffset paging; fetched in FID windows of 2000",
    "County names are upper case in source"
   ]
  },
  {
   "state": "AK",
   "dataset": "Well Log Tracking System (WELTS), Alaska Department of Natural Resources, Division of Mining, Land and Water",
   "fetched_at": "2026-11-18T19:35:24+00:00",
   "url": "https://arcgis.dnr.alaska.gov/arcgis/rest/services/OpenData/NaturalResource_WELTS/FeatureServer/0",
   "filter": "WellUse='Domestic' (about 70% of WELTS logs have no WellUse recorded and are excluded)",
   "records": 8868,
   "caveats": [
    "Region field = borough or Regional Educational Attendance Area (REAA); only boroughs/municipalities match Census counties, REAA rows will not join",
    "Only ~22% of WELTS logs state a well use, so Domestic-only is a small, self-selected subset",
    "WellDepth, StaticWaterDepth, PumpGPM stored as text, converted to feet/gpm",
    "Static level taken as StaticWaterDepth (feet below ground)"
   ]
  },
  {
   "state": "NV",
   "dataset": "Nevada Division of Water Resources (NDWR) Well Driller Reports",
   "fetched_at": "2026-11-18T19:39:58+00:00",
   "url": "https://arcgis.water.nv.gov/arcgis/rest/services/NDWR/Well_Driller_Reports/FeatureServer/0",
   "filter": "ProposedUse='Domestic' AND WorkType IN ('New','Replacement Well')",
   "records": 59003,
   "caveats": [
    "Layer has no county field: county assigned by point-in-polygon of latitude/longitude against Census TIGERweb county polygons (136 records fell outside any county polygon, listed as (unknown))",
    "Depth = DepthDrilled falling back to DepthCased; static level = StaticWaterLevel (ft below land surface); yield = 'yield' (gpm)",
    "Only WorkType New and Replacement Well kept (excludes Deepen, Plug or Abandonment, Recondition, Geothermal); deduped on WellLog number",
    "Date = WellFinishDate"
   ]
  },
  {
   "state": "KY",
   "dataset": "Kentucky Water Wells and Springs (Kentucky Groundwater Data Repository), Kentucky Geological Survey, University of Kentucky",
   "fetched_at": "2026-11-18T19:29:27+00:00",
   "url": "https://kgs.uky.edu/arcgis/rest/services/KYWater/KYWaterWells/MapServer/1",
   "filter": "primary_use LIKE 'Domestic%' (Domestic - Single Household; Domestic - Multiple Domestic Households) and GWSourceType = W (wells, springs excluded)",
   "records": 31530,
   "caveats": [
    "Kentucky Geological Survey Kentucky Groundwater Data Repository (Water Wells and Springs); no yield field in the public layer so yield columns blank",
    "Many records carry a placeholder construction date of 1900-01-01, which counts toward pre-1990 medians but not decade medians; true age of those wells unknown",
    "Static water level 0 may be flowing/at-surface or missing value; owner/PII fields not fetched"
   ]
  },
  {
   "state": "IL",
   "dataset": "ILWATER Water and Related Wells (Illinois water well records), Illinois State Geological Survey (Prairie Research Institute, University of Illinois)",
   "fetched_at": "2026-11-18T19:31:42+00:00",
   "url": "https://maps.isgs.illinois.edu/arcgis/rest/services/ILWATER/Water_and_Related_Wells/MapServer/2",
   "filter": "WELL_TYPE='PRIV' (Private Water Well; excludes Semi-Private, Household-Livestock, municipal, irrigation, monitoring, geothermal, test holes)",
   "records": 205553,
   "caveats": [
    "Illinois State Geological Survey ILWATER Water and Related Wells layer (water well records from Illinois State Water Survey/IDPH well construction reports); no static water level field in public layer so static columns blank",
    "Private-well count may include a few legacy records with approximate dates; TOTAL_DEPTH used as depth"
   ]
  },
  {
   "state": "NM",
   "dataset": "New Mexico Office of the State Engineer (OSE) Points of Diversion (well records from driller logs)",
   "fetched_at": "2026-11-18T19:31:56+00:00",
   "url": "https://services2.arcgis.com/qXZbWTdPDbTjl7Dy/arcgis/rest/services/OSE_Points_of_Diversion/FeatureServer/0",
   "filter": "use_ IN ('DOM','DOL','PDM','PDL') = 72-12-1 domestic one household, domestic+livestock, and non-72-12-1 domestic / domestic+livestock; excludes pod_status CLW (changed location of well)",
   "records": 140658,
   "caveats": [
    "Static level = static_level falling back to depth_water; feet",
    "Includes plugged/inactive wells (only pod_status CLW excluded); no hard dedupe key (a well with several POD suffixes may repeat)",
    "Domestic = standardised use_ code DOM/DOL/PDM/PDL, not the free-text use_of_well",
    "One 'Xx' county code (285 records) is not a real county"
   ]
  },
  {
   "state": "NY",
   "dataset": "Water Wells (NYSDEC Water Well Contractor Program completion reports, since April 2000) via NY GIS Clearinghouse",
   "fetched_at": "2026-11-18T19:42:43+00:00",
   "url": "https://services6.arcgis.com/DZHaqZm9cxOD4CWM/arcgis/rest/services/Water_Wells/FeatureServer/28",
   "filter": "WELLTYPE in ('Domestic','domestic supply') exact (mixed-use strings like Domestic/Irrigation excluded; geothermal excluded)",
   "records": 129786,
   "caveats": [
    "Layer has no static level or completion date, so those columns and era splits are blank",
    "PUMPCAP (pump capacity, gpm) used as yield - may be pump rating/test rate rather than a measured yield",
    "Statewide upstate-focused; Suffolk dominates (shallow Long Island wells), county mix skews depth low",
    "Reports are submitted by drillers and not verified"
   ]
  },
  {
   "state": "SC",
   "dataset": "Coastal Plain Well Inventory (SCDNR_Coastal_Plain_Well_Inventory), South Carolina Department of Natural Resources / SC Dept of Environmental Services Hydrology",
   "fetched_at": "2026-11-18T19:34:57+00:00",
   "url": "https://services.arcgis.com/acgZYxoN5Oj8pDLa/arcgis/rest/services/SCDNR_Coastal_Plain_Well_Inventory/FeatureServer/0",
   "filter": "WELL_USE='DOM' (domestic)",
   "records": 4422,
   "caveats": [
    "Coastal Plain province ONLY (about 25 counties); no Piedmont/Blue Ridge counties - SC has no statewide driller-log database online",
    "Inventory is not a complete list of Coastal Plain wells (SCDNR disclaimer); only 4,422 DOM records",
    "Static level from WL_FT text, not all rows parseable"
   ]
  },
  {
   "state": "TX",
   "dataset": "Texas Water Development Board Submitted Driller Reports",
   "fetched_at": "2026-11-18T19:36:15+00:00",
   "url": "https://services.twdb.texas.gov/arcgis/rest/services/Public/WellReports/FeatureServer/0",
   "filter": "ProposedUse='Domestic' and WellType not 'Reconditioning' (TWDB Submitted Driller Reports; depth = BoreholeDepthFt; no static level or yield fields)",
   "records": 292575,
   "caveats": [
    "DateOfWellCompletion makes the server return HTTP 400 on query, so era splits (pre1990, 2010on) are blank"
   ]
  },
  {
   "state": "NH",
   "dataset": "NHDES / NH Geological Survey Water Well Inventory (well completion reports)",
   "fetched_at": "2026-11-18T19:36:06+00:00",
   "url": "https://gis.des.nh.gov/server/rest/services/Core_GIS_Datasets/DES_Data_Secure/FeatureServer/6",
   "filter": "USE_ in ('DOMESTIC','DOMESTIC DRINKING WATER') (excludes geothermal, test, ag, community supply, municipal etc.)",
   "records": 48709,
   "caveats": [
    "Layer holds georeferenced wells only (~56k of >135k reports on NHDES OneStop)",
    "Fields are strings in source; parsed numerically",
    "County derived from TOWN via Census 2020 county subdivisions; unmapped towns go to (unknown)",
    "Static level = SWL (feet below land surface); yield = YTQ (gpm); depth = TOTD (total depth)"
   ]
  },
  {
   "state": "WI",
   "dataset": "Wisconsin Well Inventory (Well Construction Reports, private wells), Wisconsin Department of Natural Resources",
   "fetched_at": "2026-11-18T19:40:45+00:00",
   "url": "https://dnrmaps.wi.gov/arcgis2/rest/services/DG_Groundwater_Retrieval_Network/DG_Groundwater_Retrieval_Network_Ext/MapServer/0",
   "filter": "WELL_USE='PRIVATE POTABLE' from SOURCE_DATABASE='WELL CONSTRUCTION' (private well construction reports; excludes private non-potable, monitoring, loop/heat exchange, public/municipal, high-capacity)",
   "records": 494210,
   "caveats": [
    "Wisconsin DNR Well Inventory (Well Construction Reports from private-well system, 1936-present); layer includes all well-construction types New/Replacement/Reconstruction so a property can have several records",
    "Static level fetched as depth below surface; STATIC_WATER_LEV_ABOVE_BELOW not used, so a few flowing/above-ground levels may be counted as positive depth",
    "Pumping rate is drillers' test rate in gpm"
   ]
  },
  {
   "state": "DE",
   "dataset": "Non-Public Wells permit database (DNREC Division of Water, Residential Services; Delaware Environmental Navigator) via FirstMap",
   "fetched_at": "2026-11-18T19:40:47+00:00",
   "url": "https://enterprise.firstmap.delaware.gov/arcgis/rest/services/Environmental/DE_DNREC_Monitoring_Network/FeatureServer/0",
   "filter": "WellType='Domestic - Standard' and WellStatus in (Active, Completed)",
   "records": 77962,
   "caveats": [
    "Permit records, not driller logs: depth = TotalDepthActual, falling back to TotalDepthProp (proposed) when actual is 0",
    "Static level = StaticWaterLevel, yield = PumpTestRate (gpm); zeros treated as missing",
    "County assigned by point-in-polygon of Latitude/longitude against Census TIGERweb county polygons (layer has no county field)",
    "Date = ActualConstructionDate, else CompletionReportDate; many wells in Coastal Plain are shallow (<150 ft)",
    "Some well locations may be redacted/approximate per Delaware law"
   ]
  },
  {
   "state": "AZ",
   "dataset": "Arizona Department of Water Resources well registry",
   "fetched_at": "2026-11-18T19:28:48+00:00",
   "url": "https://services.arcgis.com/C34zQ7veRS0V1t04/arcgis/rest/services/Well_Registry_2024/FeatureServer/0",
   "filter": "WATER_USE='DOMESTIC' (exact, excludes combined-use strings) and not WELL_CANCELLED='Y'",
   "records": 99754,
   "caveats": []
  },
  {
   "state": "OH",
   "dataset": "Ohio DNR water well log records",
   "fetched_at": "2026-11-18T19:34:01+00:00",
   "url": "https://gis.ohiodnr.gov/arcgis/rest/services/DSW_Services/waterwells/MapServer/0",
   "filter": "WELL_USE='DOMESTIC'",
   "records": 417876,
   "caveats": []
  },
  {
   "state": "CO",
   "dataset": "Colorado Division of Water Resources (DWR) well permits (CDSS REST API)",
   "fetched_at": "2026-11-18T20:00:08+00:00",
   "url": "https://dwr.state.co.us/Rest/GET/api/v2/wellpermits/wellpermit/",
   "filter": "associatedUses contains Domestic or Household use only, with no Commercial/Industrial/Municipal/Augmentation/Geothermal/Dewatering/Monitoring/Irrigation-free-of-domestic etc. (Domestic+Stock/Irrigation allowed); excludes application/permit-stage records never built; deduped on permit number",
   "records": 148007,
   "caveats": [
    "PARTIAL: CDSS REST anonymous daily data limit ('Exceeded Daily Data Limit', HTTP 403) hit after 38 of 64 counties; missing counties: EL PASO, MESA, MINERAL, MOFFAT, MONTEZUMA, MONTROSE, MORGAN, OTERO, OURAY, PARK, PHILLIPS, PITKIN, PROWERS, PUEBLO, RIO BLANCO, RIO GRANDE, ROUTT, SAGUACHE, SAN JUAN, SAN MIGUEL, SEDGWICK, SUMMIT, TELLER, WASHINGTON, WELD, YUMA. Re-run tools/extra/fetch_co.py (skips existing) then run_co.py after the quota resets",
    "Source is the Division of Water Resources (DWR) well permit database via the CDSS REST API v2 wellpermits; one request per county",
    "Domestic = associatedUses includes Domestic or Household use only and none of Commercial/Industrial/Municipal/Augmentation/Geothermal/Dewatering/Monitoring/Power/Fishery/Recharge/Recreation/Replacement/Snow Making/Fire/Wildlife; Domestic+Stock and Domestic+Irrigation kept",
    "Records at application/permit-issued/expired/cancelled stage (never built) excluded; abandoned, replaced and final-permit records kept",
    "depthTotal, staticWaterLevel (feet) and pumpTestYield (gpm) come from well construction reports; many older permits have no depth (n_with_depth < n_records), static level and yield especially sparse",
    "Date = dateWellCompleted; dedupe on permit number"
   ]
  },
  {
   "state": "WY",
   "dataset": "Wyoming State Engineer's Office (SEO) groundwater well permits, via Wyoming State Geological Survey",
   "fetched_at": "2026-11-18T19:44:42+00:00",
   "url": "https://www.wsgs.wyo.gov/gis-files/well-spring-permits.zip",
   "filter": "Uses contains DOM_GW and no IRR_GW/IND_GW/MUN_GW/CBM/MON/TST (DOM_GW with STK/MIS allowed); deduped on permit number+prefix+suffix",
   "records": 76626,
   "caveats": [
    "Source is the WSGS compilation of Wyoming State Engineer's Office (SEO) ePermit groundwater well permits as of 2023-09-01 (not a live feed); no ArcGIS REST service found",
    "Domestic permits often have no depth/static level (only wells with a driller log or completion report carry Total_dept/StaticWate), so n_with_depth is much smaller than n_records and may skew to newer/bigger wells",
    "County not in source: assigned by point-in-polygon of Longitude/Latitude against Census TIGERweb county polygons (4 permits unplaced -> (unknown))",
    "Date used for era splits = permit priority date (not well completion date)",
    "Yield left blank: Total_Flow is the permitted/claimed rate, not a tested yield",
    "Permits include inactive/cancelled ones (IsActive not filtered)"
   ]
  },
  {
   "state": "KS",
   "dataset": "Kansas Geological Survey WWC5 water well records",
   "fetched_at": "2026-11-18T19:29:27+00:00",
   "url": "https://services2.arcgis.com/ZOdjAzAQ2B0f85zi/arcgis/rest/services/Water_Wells_WWC5/FeatureServer/0",
   "filter": "WELL_TYPE_CATEGORY='Domestic' (USE_DESC Domestic; Domestic+Lawn/Garden; Domestic+Livestock; Domestic changed from ...)",
   "records": 150792,
   "caveats": []
  }
 ]
}