RF-HUB API

API Updated 2026-05-27

RF-HUB exposes a REST API on the same IP as the web interface — no extra configuration is needed. You can find the IP address under the Info tab.

For real-time control and push events, there is also an MQTT API — see MQTT API for RF-HUB.

Devices and control — `/api/iot`

List all devices

GET http://<rfhub-ip>/api/iot

Returns a JSON array with all devices, their endpoints, current status, and timestamp for the last update:

[
  {
    "name": "Kitchen lighting",
    "typeId": 1,
    "brand": "Telldus",
    "addr": 12345,
    "endpoints": [
      {
        "nr": 1,
        "name": "Ceiling lamp",
        "type": "switch",
        "state": "ON",
        "lastUpdated": "2026-05-20T22:30:15"
      }
    ]
  }
]

Get a specific device

GET http://<rfhub-ip>/api/iot/<typeId>/<addr>

Same JSON structure but only for one device.

Send a command to an endpoint

GET http://<rfhub-ip>/api/iot/<typeId>/<addr>/<endpointNr>?set=ON

Sends the 433 MHz signal and returns:

{
  "typeId": 1,
  "addr": 12345,
  "endpointNr": 1,
  "command": "ON",
  "sent": true
}

Common commands: ON, OFF, or numeric values for dimmers.

System status and management

Endpoint	Description
`GET /status`	App, version, UID, WiFi connection, IP, OTA progress.
`GET /reboot`	Reboots the hub.
`GET /factory`	Factory reset.
`GET /wifi?ssid=...&password=...`	Changes the WiFi connection.
`GET /backup?sections=settings,devices,schedules,automations`	Downloads a backup file. `sections` is optional — omit for a full backup.
`POST /restore`	Restores from a backup file.
`POST /ota`	OTA firmware update (send `.bin` as multipart upload).

Example — curl

curl "http://192.168.1.50/api/iot/1/12345/1?set=ON"

Example — Python

import requests

RFHUB = "http://192.168.1.50"

# List devices
devices = requests.get(f"{RFHUB}/api/iot").json()
for d in devices:
    print(d["name"], "→", [(e["name"], e["state"]) for e in d["endpoints"]])

# Turn on a specific endpoint
requests.get(f"{RFHUB}/api/iot/1/12345/1", params={"set": "ON"})

Webhooks?

RF-HUB itself does not send outgoing HTTP webhooks. If you need that, the easiest approach is via Home Assistant's webhook automations — RF-HUB publishes the event via MQTT, and HA makes the HTTP call to your service.

Questions

Missing an endpoint or need help with a specific integration — get in touch.

Devices and control — /api/iot