API reference/Natural Hazards/US River Gauge Detail

US River Gauge Detail

One USGS gauge: every current reading (streamflow, water level, temperature, water quality), the last 24 hours of streamflow hourly with a rising, falling or steady trend, and the record annual peak flow with today’s flow as a share of it.

GET/api/v1/hazards/river-gauge

Data source

Query parameters

ParameterDescriptionTry value
site
string required
USGS site number, e.g. 01646500 (Potomac River at Little Falls); find one with /hazards/river-gauges
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.