Documentation

← Back to site

List all subdevices

Last updated on May 20, 2015 14:05

This method lists all subdevices in your account, along with information basic status and usage information.

URL

/api/v1/subdevices/list

Parameters

No parameters are required.

Response

This method returns an array of subdevices. Properties may vary between objects depending on their device_type. Below is an example of an network connected eCalm socket, and an eTRV wireless valve.

[
  {
    "id": 1,
    "device_id": 1,
    "label": "My Radio Socket",
    "power_state": 1,
    "startup_mode": 0,
    "aggregated_hourly_at": "2014-10-09T11:58:18.000Z",
    "aggregated_daily_at": "2014-10-09T11:58:18.000Z",
    "device_type": "ecalm",
    "remote_id": 1,
    "today_wh": 1500
    "today_wh_range": "medium"
    "last_data_instant": 100
    "unknown_state?": false
    "voltage": 241.0,
    "voltage_reported_at": "2014-10-09T11:58:18.000Z",
    "frequency": 50.0,
    "real_power": 0.0,
    "reactive_power": 0.0,
    "device_groups": [
      {
        "id": 1,
        "name": "My Devices",
        "user_id": 1
      }
    ] 
  },
  {
    "id": 2,
    "device_id": 1,
    "label": "My eTRV",
    "aggregated_hourly_at": "2014-10-09T11:58:18.000Z",
    "aggregated_daily_at": "2014-10-09T11:58:18.000Z",
    "device_type": "etrv",
    "remote_id": 2,
    "device_groups": [
      {
        "id": 1,
        "name": "My Devices",
        "user_id": 1
      }
    ],
    "last_temperature": 18,
    "target_temperature": 20
    "voltage": 3.5,
    "voltage_reported_at": "2014-10-09T11:58:18.000Z",
    "frequency": null,
    "real_power": null,
    "reactive_power": null
  }
]