GET

/v3/now/{venue_id}

Fetches a real-time snapshot. Use optional parameters to include current and forecasted weather.

Required Headers

x-api-key

Secure user specific key.

Required

Query Parameters

fieldsOptional
csv string
Comma-separated list used to switch on conditional sub-objects.
weather - Include current local atmospheric metrics.weather_forecast - Include daily and hourly forecast blocks.

Response

refresh_hint_seconds intAlways Present

An estimated number of seconds to wait before calling the API again and expecting the response to have changed.

venue Object (VenueDetails)Always Present
id string
name string
display_name string | null
locale | null string | null
timezone string
water Object (WaterValues)Always Present
sensor string
timestamp ISO8601 Date
battery float | null
internal_temperature float | null
temperature float | null
weather Object (CurrentWeather)Query Triggered
time ISO8601 Date
description string
openweather_code int
temperature float
feels_like_temperature float | null
wind_speed_mph float | null
wind_gust_mph float | null
wind_direction int | null
wind_direction_compass string | null
weather_forecast Object (WeatherForcast)Query Triggered

hourly [ ] Array of HourlyForecast

dt int (Unix Timestamp)
temp float
feels_like float
humidity int
pop float (Probability of Precipitation)
description string
is_day bool

daily [ ] Array of DailyForecast

dt int (Unix Timestamp)
summary string
description string
temp Structure:
day: float
min: float
max: float
night: float
alerts Map Key enum objectMay be present

Map keys correspond to active system diagnostic flags:

battery_lowbattery_critstale_3hstale_6h
venue_id string
alert_type string
first_noted ISO8601 Date
label string
description string

Implementation Frame

curl -X GET "https://api.my-water.live/v3/now/tooting-bec-lido?fields=weather,weather_forecast" \
  -H "x-api-key: your_venue_private_api_token"
JSON Response
200 OK
{
 "refresh_hint_seconds": 892,
  "venue": {
    "id": "tooting-bec-lido",
    "name": "Tooting Bec Lido",
    "display_name": "Tooting Bec Lido (Skins)",
    "locale": "en-GB",
    "timezone": "Europe/London"
  },
  "water": {
    "sensor": "tx-sensor-01-bec",
    "timestamp": "2026-05-29T10:25:00Z",
    "battery": 88.5,
    "internal_temperature": 21.4,
    "temperature": 14.8
  },
  "weather": {
    "time": "2026-05-29T10:20:00Z",
    "description": "scattered clouds",
    "openweather_code": 802,
    "clouds": 40,
    "wind_speed": 4.5,
    "wind_speed_mph": 10.06,
    "wind_gust": 0,
    "wind_gust_mph": 0,
    "wind_direction": 280,
    "wind_direction_compass": "W",
    "temperature": 16.2,
    "feels_like_temperature": 15.4,
    "sunrise_time": "2026-05-29T04:51:00Z",
    "sunset_time": "2026-05-29T21:05:00Z"
  },
  "weather_forecast": {
    "hourly": [
      {
        "dt": 1748516400,
        "temp": 17.1,
        "feels_like": 16.4,
        "humidity": 62,
        "pop": 0.12,
        "openweather_code": 800,
        "description": "clear sky",
        "is_day": true
      }
    ],
    "daily": [
      {
        "dt": 1748520000,
        "summary": "Expect a beautifully clear morning for an outdoor swim",
        "temp": {
          "day": 18.5,
          "min": 11.2,
          "max": 19.5,
          "night": 12.1,
          "eve": 16.3,
          "morn": 13.4
        },
        "openweather_code": 800,
        "description": "clear sky"
      }
    ]
  },
  "alerts": {
    "stale_3h": {
      "venue_id": "tooting-bec-lido",
      "alert_type": "stale_3h",
      "first_noted": "2026-05-29T07:25:00Z",
      "label": "Stale Data (3h)",
      "description": "No data has been received for 3 hours."
    }
  }
}