Water level and device status, straight from your home network.

Find the device IP

First request

A simple HTTP GET is enough. Replace the IP with your device’s address. You can also enter it directly in your browser’s address bar.

curl http://192.168.1.42/status

Method

GET

Path

/status

Port

80 (HTTP)

Auth

none

Response & fields

The response is a JSON object with Content-Type: application/json and Cache-Control: no-store. A request does not trigger a new measurement – it returns the last known value and its age.

{
  "deviceId": "drainbee",
  "firmwareVersion": "1.2.5",
  "uptimeMs": 86400000,
  "measurement": {
    "cm": 42,
    "ageMs": 3200
  },
  "wifi": {
    "isConnected": true,
    "localIp": "192.168.1.42",
    "rssiDbm": -61
  },
  "mqtt": {
    "isConnected": false
  },
  "memory": {
    "freeHeapBytes": 142000,
    "minFreeHeapBytes": 98000,
    "largestFreeBlockBytes": 86000
  }
}

Later firmware versions may add fields. Do not rely on the order of keys.

Integration examples

All examples read measurement.cm and handle null – there is no value before the first measurement. These are ordinary HTTP requests; there is no native Drainbee integration, Matter or HomeKit support.

sensor:
  - platform: rest
    name: "Drainbee water level"
    unique_id: drainbee_water_level
    resource: http://192.168.1.42/status
    scan_interval: 60
    timeout: 5
    unit_of_measurement: "cm"
    device_class: distance
    state_class: measurement
    availability: "{{ value_json.measurement.cm is number }}"
    value_template: "{{ value_json.measurement.cm }}"
    json_attributes_path: "$.measurement"
    json_attributes:
      - ageMs

const measurement = msg.payload?.measurement;
if (typeof measurement?.cm !== "number") {
  node.status({ fill: "grey", shape: "ring", text: "No measurement yet" });
  return null;
}
msg.ageMs = measurement.ageMs;
msg.payload = measurement.cm;
node.status({ fill: "blue", shape: "dot", text: measurement.cm + " cm" });
return msg;

const STATE_ID = "javascript.0.drainbee.water_level_cm";
createState(STATE_ID, null, {
  type: "number", role: "value", unit: "cm",
  read: true, write: false
}, () => {
  schedule("*/1 * * * *", () => {
    httpGet("http://192.168.1.42/status", { timeout: 5000 }, (err, response) => {
      if (err || response.statusCode !== 200) {
        setState(STATE_ID, null, true);
        log("Drainbee unreachable", "warn");
        return;
      }
      try {
        const cm = JSON.parse(response.data).measurement?.cm;
        setState(STATE_ID, typeof cm === "number" ? cm : null, true);
      } catch {
        setState(STATE_ID, null, true);
      }
    });
  });
});

import json
import urllib.error
import urllib.request

def water_level_cm(ip="192.168.1.42", timeout=5):
    with urllib.request.urlopen(f"http://{ip}/status", timeout=timeout) as response:
        data = json.load(response)
    return data["measurement"]["cm"]

try:
    cm = water_level_cm()
    print("No measurement yet" if cm is None else f"{cm} cm")
except (OSError, urllib.error.URLError, ValueError, KeyError) as error:
    raise SystemExit(f"Drainbee unreachable: {error}")

Errors & help

200

OK

Status as JSON. Individual fields may be null.

404

Not Found

Unknown path. Only /status exists – paths such as /value are not available in firmware 1.2.5.

405

Method Not Allowed

Only GET is supported. POST, PUT and DELETE are rejected.

503

Service Unavailable

The status could not be generated. Wait briefly and try again.

No response? Check these in order:

1. 1

   Is the IP correct?

   Compare it with Device settings → Local IP in the app or your router’s device list. It may change after a router restart; a DHCP reservation helps.

2. 2

   Is the firmware up to date?

   GET /status is available from 1.2.5. Older firmware does not respond on this path. Check the version in the app’s device settings.

3. 3

   On the same network?

   Guest networks and separate Wi-Fi networks, such as an IoT VLAN, often block access between devices. Your client must share Drainbee’s network or have a route to it.

4. 4

   Does Drainbee have power and Wi-Fi?

   Check the power supply and your router’s device list. The local API needs Wi-Fi. Losing the cloud connection alone does not prevent local access.

5. 5

   Wrong protocol?

   Use http://, not https://. Some browsers add https automatically – enter the address with http:// explicitly.

Network & security

The local API is intended for your trusted home network. It has no authentication or HTTPS. Anyone who can reach Drainbee on the network can read its status, but cannot change anything through this API.