Response
{
"example": {
"caveats": [
"Gauge observations are point measurements at stream/river stations, not a parcel flood prediction or insurance determination.",
"Nearby gauges may be on a different drainage basin than the property; verify watershed relevance with local floodplain or stormwater staff."
],
"componentStatus": [
{
"component": "usgs_observations",
"status": "ok"
},
{
"component": "nws_nwps_thresholds",
"status": "ok"
}
],
"gauges": [
{
"agency": "USGS",
"distanceMeters": 1531,
"name": "PIGEON HOUSE CR AT DORTCH STREET AT RALEIGH, NC",
"nws": {
"forecast": {
"floodCategory": "fcst_not_current"
},
"gaugeId": "0208732544",
"lid": "DRCN7",
"observed": {
"floodCategory": "no_flooding",
"stage": 1.99,
"unit": "ft",
"validTime": "2026-09-23T00:10:00Z"
},
"officialUrl": "https://water.noaa.gov/gauges/DRCN7",
"thresholds": {
"action": 14,
"flood": 15,
"major": 20,
"minor": 15,
"moderate": 18
},
"usgsId": "0208732544"
},
"observations": [
{
"observedAt": "2026-09-22T20:55:00.000-04:00",
"parameterCode": "00065",
"parameterName": "Gage height, ft",
"qualifiers": [
"P"
],
"unit": "ft",
"value": 1.96
}
],
"officialUrl": "https://waterdata.usgs.gov/monitoring-location/0208732544",
"point": {
"latitude": 35.793892,
"longitude": -78.642597
},
"siteId": "0208732544"
},
{
"agency": "USGS",
"distanceMeters": 1614,
"name": "PIGEON HOUSE CR AT CAMERON VILLAGE AT RALEIGH, NC",
"nws": {
"forecast": {
"floodCategory": "fcst_not_current"
},
"gaugeId": "0208732534",
"lid": "PIGN7",
"observed": {
"floodCategory": "no_flooding",
"stage": 1.41,
"unit": "ft",
"validTime": "2026-09-23T00:30:00Z"
},
"officialUrl": "https://water.noaa.gov/gauges/PIGN7",
"thresholds": {
"action": 5,
"flood": 6,
"major": 11,
"minor": 6,
"moderate": 8
},
"usgsId": "0208732534"
},
"observations": [
{
"observedAt": "2026-09-22T21:00:00.000-04:00",
"parameterCode": "00060",
"parameterName": "Streamflow, ft³/s",
"qualifiers": [
"P"
],
"unit": "ft3/s",
"value": 0.03
},
{
"observedAt": "2026-09-22T21:00:00.000-04:00",
"parameterCode": "00065",
"parameterName": "Gage height, ft",
"qualifiers": [
"P"
],
"unit": "ft",
"value": 1.41
}
],
"officialUrl": "https://waterdata.usgs.gov/monitoring-location/0208732534",
"point": {
"latitude": 35.7875,
"longitude": -78.6547222
},
"siteId": "0208732534"
}
],
"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.",
"ok": true,
"point": {
"latitude": 35.780418000003195,
"longitude": -78.63910200000142
},
"provenance": {
"coverage": "United States where USGS/NWS gauges publish observations or threshold metadata",
"nwsServiceUrl": "https://api.water.noaa.gov/nwps/v1/",
"nwsSourcePage": "https://water.noaa.gov/about/api",
"source": "USGS National Water Information System + NOAA/NWS National Water Prediction Service",
"usgsServiceUrl": "https://waterservices.usgs.gov/nwis/iv/",
"usgsSourcePage": "https://www.usgs.gov/tools/usgs-water-data-apis"
},
"radiusMeters": 10000,
"verifyNext": [
{
"source": "USGS",
"step": "Open each USGS monitoring-location page for current observations and station metadata.",
"url": "https://waterdata.usgs.gov/monitoring-location/"
},
{
"source": "NOAA/NWS",
"step": "Open the matching NOAA/NWS NWPS gauge page for flood-category thresholds and forecasts where available.",
"url": "https://water.noaa.gov/"
}
]
},
"type": "json"
}