> ## Documentation Index
> Fetch the complete documentation index at: https://docs.axiomancer.io/llms.txt
> Use this file to discover all available pages before exploring further.

# River Levels

> Real-time USGS gauge data for waterways critical to grain barge transport — endpoints for stage, discharge, and forecast alerts on US inland navigation routes.

Real-time USGS gauge data for waterways critical to grain barge transport.

## `GET` `/api/v1/river-levels`

<Note>Requires API key.</Note>

Live river water levels for Mississippi, Ohio, Illinois, Columbia rivers and Houston. Returns level in feet with status alerts (normal/low/critical/flood).

**Response**

```json theme={null}
{ "readings": [{ "name", "river", "level_ft", "status", "critical_low_ft", "flood_stage_ft" }], "alerts": [...] }
```

**Example**

```bash theme={null}
curl -X GET -H "X-API-Key: YOUR_KEY" \
  https://axiomoverwatch.io/api/v1/river-levels
```