fourzerotwo
← Catalog
environment by fourzerotwo

UK River Levels, Flow & Rainfall

The measured hydrometric record from the Environment Agency Hydrology API (distinct from flood warnings).

cost
Free every endpoint, within the daily allowance
after that
from $0.001 / call · card or USDC
endpoints
6

No signup needed over MCP: 100 free calls a day, or 500 with a free key.

Gauges near a point Free

River level, flow, rainfall and groundwater stations within a radius (default 10 km, max 25) of a postcode or point, nearest first.

cost
Free then $0.002 / call
MCP tool
uk-rivers__stations-near
method
GET

Free up to 100 calls a day over MCP (500 with a free key), then $0.002 per call by card credit or USDC. Free key · Pay by card

GET https://fourzerotwo.si/v1/uk-rivers/stations-near

ParamTypeDescription
postcode? string UK postcode (or give lat and lng)
lat? string Latitude
lng? string Longitude
type? string level | flow | rainfall | groundwater
radius_km? integer Radius in km (default 10)
limit? integer Max results (default 25)
# free: send a free key from https://fourzerotwo.si/free
curl -H "X-API-Key: fzt_…" "https://fourzerotwo.si/v1/uk-rivers/stations-near"

# no key: returns 402 with the price, for x402 agents
curl -i "https://fourzerotwo.si/v1/uk-rivers/stations-near"

by fourzerotwo

Report this endpoint

Gauge details Free

One station: river, location, catchment area, date opened and its measures.

cost
Free then $0.001 / call
MCP tool
uk-rivers__station
method
GET

Free up to 100 calls a day over MCP (500 with a free key), then $0.001 per call by card credit or USDC. Free key · Pay by card

GET https://fourzerotwo.si/v1/uk-rivers/station

ParamTypeDescription
id string Hydrology station id (from stations-near or search)
# free: send a free key from https://fourzerotwo.si/free
curl -H "X-API-Key: fzt_…" "https://fourzerotwo.si/v1/uk-rivers/station?id=839866a2-80ca-42a8-a695-8e6d6b165fa6"

# no key: returns 402 with the price, for x402 agents
curl -i "https://fourzerotwo.si/v1/uk-rivers/station?id=839866a2-80ca-42a8-a695-8e6d6b165fa6"

by fourzerotwo

Report this endpoint

Latest reading Free

The latest reading for each measure of a type (level, flow, rainfall or groundwater) at a station.

cost
Free then $0.002 / call
MCP tool
uk-rivers__latest
method
GET

Free up to 100 calls a day over MCP (500 with a free key), then $0.002 per call by card credit or USDC. Free key · Pay by card

GET https://fourzerotwo.si/v1/uk-rivers/latest

ParamTypeDescription
id string Hydrology station id (from stations-near or search)
type string level | flow | rainfall | groundwater
# free: send a free key from https://fourzerotwo.si/free
curl -H "X-API-Key: fzt_…" "https://fourzerotwo.si/v1/uk-rivers/latest?id=839866a2-80ca-42a8-a695-8e6d6b165fa6&type=level"

# no key: returns 402 with the price, for x402 agents
curl -i "https://fourzerotwo.si/v1/uk-rivers/latest?id=839866a2-80ca-42a8-a695-8e6d6b165fa6&type=level"

by fourzerotwo

Report this endpoint

Recent readings Free

Recent 15-minute readings (or daily means) for one type at a station, up to 7 days, newest first.

cost
Free then $0.002 / call
MCP tool
uk-rivers__readings
method
GET

Free up to 100 calls a day over MCP (500 with a free key), then $0.002 per call by card credit or USDC. Free key · Pay by card

GET https://fourzerotwo.si/v1/uk-rivers/readings

ParamTypeDescription
id string Hydrology station id (from stations-near or search)
type string level | flow | rainfall | groundwater
days? integer Days back (1–7, default 1)
# free: send a free key from https://fourzerotwo.si/free
curl -H "X-API-Key: fzt_…" "https://fourzerotwo.si/v1/uk-rivers/readings?id=839866a2-80ca-42a8-a695-8e6d6b165fa6&type=level"

# no key: returns 402 with the price, for x402 agents
curl -i "https://fourzerotwo.si/v1/uk-rivers/readings?id=839866a2-80ca-42a8-a695-8e6d6b165fa6&type=level"

by fourzerotwo

Report this endpoint

Rainfall near a point Free

The nearest rain gauges to a postcode or point with their latest rainfall totals.

cost
Free then $0.003 / call
MCP tool
uk-rivers__rainfall-near
method
GET

Free up to 100 calls a day over MCP (500 with a free key), then $0.003 per call by card credit or USDC. Free key · Pay by card

GET https://fourzerotwo.si/v1/uk-rivers/rainfall-near

ParamTypeDescription
postcode? string UK postcode (or give lat and lng)
lat? string Latitude
lng? string Longitude
radius_km? integer Radius in km (default 10)
# free: send a free key from https://fourzerotwo.si/free
curl -H "X-API-Key: fzt_…" "https://fourzerotwo.si/v1/uk-rivers/rainfall-near"

# no key: returns 402 with the price, for x402 agents
curl -i "https://fourzerotwo.si/v1/uk-rivers/rainfall-near"

by fourzerotwo

Report this endpoint

This uses Environment Agency hydrology data from the real-time data API (Beta), licensed under the Open Government Licence v3.0.