Copy page

River Gauge

Guide

The River Gauge API provides river water level observations, station metadata, and flood stage information.

For full request and response field details, see River Gauge Parameters.

Endpoint	Description
Observations	River gauge observation data by country, bounding box, or all
Stations	Station metadata by country, bounding box, or all
River status	River flood status definitions

---

Observations

Search observation data using any one of three methods:

• Search by country code or by country code and administrative area.
• Search by a bounding box, defined by latitude and longitude values.
• Return all available observations.

Observations by country code or by country code and administrative area

Code
https://{baseUrl}/rivers/{version}/{country code}/{admin code}/observations{.format}?apikey={API key}&metric={boolean}&includeunits={boolean}

Example

Code
https://api.accuweather.com/rivers/v1/US/VA/observations.json?apikey={API key}&metric=true&includeunits=true

Code
[
    {
        "observation": {
            "dateTime": "2024-04-09T15:30:00-04:00",
            "height": {
                "value": 1.3,
                "unit": "m"
            }
        },
        "categories": {
            "action": {
                "value": 1.8,
                "unit": "m"
            },
            "flood": {
                "value": 3.7,
                "unit": "m"
            },
            "moderate": {
                "value": 4.6,
                "unit": "m"
            },
            "major": {
                "value": 5.5,
                "unit": "m"
            },
            "lowThreshold": null
        },
        "id": "AFRV2",
        "location": {
            "name": "Alexandria",
            "countryCode": "US",
            "adminCode": "VA"
        },
        "waterBody": "Four Mile Run",
        "status": {
            "name": "No Flooding",
            "colorHex": "#00ff00"
        }
    },
    {...}
]

Observations by bounding box

Code
https://{baseUrl}/rivers/{version}/observations{.format}?apikey={API key}&upperleft={lat,lon}&lowerright={lat,lon}&metric={boolean}&includeunits={boolean}

Example

Code
https://api.accuweather.com/rivers/v1/observations.geojson?apikey={API key}&upperleft=61,-148&lowerright=20,-70&metric=false

Code
{
    "type": "FeatureCollection",
    "features": [
        {
            "type": "Feature",
            "geometry": {
                "coordinates": [
                    -97.7933349609375,
                    30.221111297607422
                ],
                "type": "Point"
            },
            "properties": {
                "observation": {
                    "dateTime": "2024-04-09T19:30:00+00:00",
                    "height": 0.6
                },
                "categories": {
                    "action": null,
                    "flood": 4,
                    "moderate": 4.3,
                    "major": 5.5,
                    "lowThreshold": null
                },
                "id": "AAIT2",
                "location": {
                    "name": "Manchaca Road at Austin",
                    "countryCode": "US",
                    "adminCode": "TX"
                },
                "waterBody": "Williamson Creek",
                "status": {
                    "name": "No Flooding",
                    "colorHex": "#00ff00"
                }
            }
        },
        {...}
    ]
}

All available observations

Code
https://{baseUrl}/rivers/{version}/observations{.format}?apikey={API key}&metric={boolean}&includeunits={boolean}

Example

Code
https://api.accuweather.com/rivers/v1/observations?apikey={API key}

Code
[
    {
        "observation": {
            "dateTime": "2024-04-09T19:30:00+00:00",
            "height": 2
        },
        "categories": {
            "action": null,
            "flood": 13,
            "moderate": 14,
            "major": 18,
            "lowThreshold": null
        },
        "id": "AAIT2",
        "location": {
            "name": "Manchaca Road at Austin",
            "countryCode": "US",
            "adminCode": "TX"
        },
        "waterBody": "Williamson Creek",
        "status": {
            "name": "No Flooding",
            "colorHex": "#00ff00"
        }
    },
    {...}
]

Stations

Code
https://{baseUrl}/rivers/{version}/{country code}/{admin code}/stations{.format}?apikey={API key}

Example

Code
https://api.accuweather.com/rivers/v1/US/VA/stations.geojson?apikey={API key}

Code
{
    "type": "FeatureCollection",
    "features": [
        {
            "type": "Feature",
            "geometry": {
                "coordinates": [
                    -81.98332977294922,
                    36.68583297729492
                ],
                "type": "Point"
            },
            "properties": {
                "id": "ABDV2",
                "goesId": "24415608",
                "dcpOwner": "TENNVA",
                "hydrologicServiceArea": "MRX",
                "location": {
                    "name": "ABINGTON",
                    "countryCode": "US",
                    "adminCode": "VA"
                }
            }
        },
        {...}
    ]
}

River status

Code
https://{baseUrl}/rivers/{version}/statuses{.format}?apikey={API key}

Example

Code
https://api.accuweather.com/rivers/v1/statuses.json?apikey={API key}

Code
[
    {
        "id": "action",
        "name": "Near Flood Stage",
        "colorHex": "#ffff00"
    },
    {
        "id": "low_threshold",
        "name": "At or Below Low Water Threshold",
        "colorHex": "#906320"
    },
    {
        "id": "major",
        "name": "Major Flooding",
        "colorHex": "#cc33ff"
    },
    {...}
]