Locus: Property Scan – Groundwater Context

{
  "type": "json",
  "example": {
    "ok": true,
    "note": "Awareness/diagnostic only. Full briefs are x402-paid. Agents can discover live free tools at https://api.locus.report/tools/list and paid tools, prices, and manifests at https://api.locus.report/.well-known/ai-tool/index.json.",
    "point": {
      "latitude": 35.78041800000319,
      "longitude": -78.63910200000142
    },
    "state": "data",
    "caveats": [
      "USGS groundwater monitoring wells are often purpose-drilled observation wells, not domestic wells; their construction depths and water levels do not predict the depth, yield, or feasibility of a future household well.",
      "USGS fields are sparse. A missing well depth or aquifer code is reported as unknown rather than zero, shallow, or evidence that no aquifer is present."
    ],
    "message": "Nearby USGS groundwater monitoring records were found. They describe observation locations and do not predict a domestic well at the subject property.",
    "provenance": {
      "source": "USGS Water Data OGC API",
      "fetchedAt": "2026-09-23T01:11:21.665Z",
      "sourcePage": "https://api.waterdata.usgs.gov/ogcapi/v0/collections/monitoring-locations",
      "fieldMeasurementsCollection": "https://api.waterdata.usgs.gov/ogcapi/v0/collections/field-measurements/items",
      "monitoringLocationsCollection": "https://api.waterdata.usgs.gov/ogcapi/v0/collections/monitoring-locations/items"
    },
    "verifyNext": [
      {
        "url": "https://api.waterdata.usgs.gov/ogcapi/v0/collections/monitoring-locations",
        "step": "Open the USGS Water Data monitoring-location collection and verify the cited monitoring-location ID and measurement series."
      },
      {
        "url": "https://api.locus.report/tools/call",
        "step": "Check locus_sole_source_aquifer for EPA designation context: it explains federal project review under SDWA -1424(e), not current water quality or a private-owner restriction."
      }
    ],
    "radiusMeters": 5000,
    "componentStatus": {
      "aquiferNames": "ok",
      "fieldMeasurements": "ok",
      "monitoringLocations": "ok"
    },
    "monitoringWells": {
      "aquifers": [
        {
          "code": "N400PDMBRX",
          "name": "Piedmont and Blue Ridge crystalline-rock aquifers",
          "scope": "national",
          "monitoringWellCount": 69
        },
        {
          "code": "110SPRL",
          "name": "Saprolite",
          "scope": "local",
          "monitoringWellCount": 1
        }
      ],
      "totalFound": 69,
      "queryLimited": false,
      "depthDistribution": {
        "max": 800,
        "min": 18,
        "unit": "ft below land-surface datum",
        "median": 245,
        "unknownCount": 3,
        "reportedCount": 66,
        "totalWellCount": 69
      },
      "aquiferUnknownCount": 0,
      "aquiferReportedCount": 69
    },
    "staticWaterLevel": {
      "trend": {
        "basis": "58 static measurements across 8 distinct years and 7.17 years; insufficient for a directional statement under the conservative Locus threshold.",
        "fitR2": null,
        "status": "insufficient_record",
        "direction": null,
        "spanYears": 7.17,
        "unitPerYear": null,
        "annualChange": null,
        "measurementCount": 58,
        "distinctYearCount": 8
      },
      "status": "observed",
      "mostRecent": {
        "kind": "elevation_above_vertical_datum",
        "unit": "ft",
        "datum": "NAVD88",
        "value": 313.39,
        "measuredAt": "2026-08-13T17:41:00+00:00",
        "distanceBand": "1_to_3_km",
        "parameterCode": "62611",
        "approvalStatus": "Approved",
        "distanceBandLabel": "1-3 km away",
        "monitoringLocationId": "USGS-354649078400702"
      },
      "multiYearRecordExists": true
    }
  }
}