API reference/Natural Hazards/US River Gauges Nearby

US River Gauges Nearby

Active USGS stream gauges near a point, nearest first: the latest streamflow (cubic feet per second) and water level (feet) with their reading time, gauge name, county, drainage area and distance. Only gauges that reported in the last 7 days are listed.

GET/api/v1/hazards/river-gauges

Data source

Query parameters

ParameterDescriptionTry value
lat
number required
Latitude
lon
number required
Longitude
radiusKm
number
Search radius in km (default 25, max 100)
limit
number
Gauges (default 20, max 50)
apikey
string required
Your API key. Can also be sent as the X-API-Key header.demo key used here

Response envelope

Success: { data, meta: { sources, fetchedAt, cached } }. Errors: { error: { code, message } } with HTTP 400, 401, 404, 502, 503 or 504.