locus groundwater context derived

{
  "input": {
    "body": {
      "address": "1 E Edenton St, Raleigh, NC 27601",
      "radiusMeters": 5000
    },
    "type": "http",
    "method": "POST",
    "bodyType": "json"
  },
  "output": {
    "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.780418000003195,
        "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
      }
    }
  }
}