Skip to main content

​
Overview

Returns a list of all devices known to the server, with full status for each. When require_device_pairing is enabled (see environment config), only devices that have completed the pairing/registration flow are returned. Otherwise, all devices the server has seen are returned.

​
Endpoint

GET http://your-server:8082/api/devices

​
Response

​
Success (200 OK)

{
  "devices": [
    {
      "serial": "02AB01AC012345678",
      "api_key": "02AB01AC012345678",
      "is_available": true,
      "last_seen": "2026-04-01T12:00:00",
      "name": "Living Room",
      "current_temperature": 20.5,
      "target_temperature": 21.0,
      "mode": "heat",
      "hvac": {
        "heater": true,
        "ac": false,
        "fan": false
      },
      "capabilities": {
        "can_heat": true,
        "can_cool": false,
        "has_fan": false,
        "has_emer_heat": false,
        "has_humidifier": false,
        "has_dehumidifier": false
      },
      "eco_mode": "schedule",
      "subscription_count": 1,
      "away": false,
      "schedule_mode": "HEAT"
    }
  ],
  "total": 1
}

​
Response Fields

FieldTypeDescription
devicesarrayArray of device status objects
totalnumberTotal device count
devices[].subscription_countnumberNumber of active subscribe connections
Each device object contains the same fields as GET /status.

​
Examples

curl http://your-server:8082/api/devices

GET /status

Full status for a single device

POST /api/register

Register a new device