List Thermostats

POST /thermostats/list ⇒ { devices: [device, …] }

Returns a list of all thermostats.

JavaScript

Request

await seam.thermostats.list();

Response

[
  {
    "device_id": "123e4567-e89b-12d3-a456-426614174000",
    "device_type": "ecobee_thermostat",
    "capabilities_supported": ["thermostat"],
    "properties": {
      "name": "Entryway",
      "online": "true,",
      "relative_humidity": 0.36,
      "temperature_farenheit": 70,
      "available_hvac_mode_settings": ["cool", "heat", "heat_cool", "off"],
      "current_climate_setting": {
        "hvac_mode_setting": "heat_cool",
        "cooling_set_point_farenheit": 75,
        "heating_set_point_farenheit": 65,
        "manual_override_allowed": false
      },
      "location": null,
      "connected_account_id": "123e4567-e89b-12d3-a456-426614174000",
      "workspace_id": "123e4567-e89b-12d3-a456-426614174000",
      "created_at": "2024-04-05T07:57:05.323Z"
    }
  }
]

Python

Ruby

PHP

Seam CLI

Go

Authentication Methods

• API key

• Client session token

• Personal access token Must also include the seam-workspace header in the request.

Request Parameters

connect_webview_id

Type: string Required: No

ID of the Connect Webview by which to filter devices.

---

connected_account_id

Type: string Required: No

ID of the connected account by which to filter.

---

connected_account_ids

Type: array Required: No

Array of IDs of the connected accounts by which to filter devices.

---

created_before

Type: string Required: No

Date threshold for devices to return. If specified, returns only devices created before the specified date.

---

custom_metadata_has

Type: object Required: No

Set of key:value custom metadata pairs by which you want to filter devices.

---

device_ids

Type: array Required: No

Array of device IDs by which to filter devices.

---

device_type

Type: string Required: No

Device type by which to filter devices.

---

device_types

Type: array Required: No

Array of device types by which to filter devices.

---

limit

Type: number Required: No

Numerical limit on the number of devices to return.

---

manufacturer

Type: string Required: No

Manufacturer by which to filter devices.

---

user_identifier_key

Type: string Required: No

Your own internal user ID for the user by which to filter devices.

---

Return Type

Array<device>