BC Data docs

hydrometric_latest

Latest river level and flow at B.C. stations (ECCC hydrometric)

The newest water level (metres) and discharge (cubic metres per second) at B.C. Water Survey of Canada stations, by station id, part of a name, or the nearest stations to a point. Real-time and provisional, read hourly from ECCC's datamart; only the latest reading is held, not a history. Not a flood warning.

Cost: 2 units of your allowance (see Rate limits).

Parameters

  • station_id (string, optional)
  • query (string, optional): min length 2, max length 60
  • lat (number, optional): min 48, max 61
  • lon (number, optional): min -141, max -113
  • radius_km (number, optional): max 100
  • limit (integer, optional): min 1, max 25

REST

curl -X POST https://api.bcmcp.ca/v1/tools/hydrometric_latest \
  -H "Authorization: Bearer $BCDATA_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

MCP

Call the tool hydrometric_latest with these arguments. Over raw JSON-RPC:

curl -X POST https://api.bcmcp.ca/mcp \
  -H "Authorization: Bearer $BCDATA_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"hydrometric_latest","arguments":{}}}'

What comes back

Every answer is the same envelope, over REST and over MCP: available, data, citations, freshness and notes. See Citations and freshness.

On this page