Sign-Up Supported Devices

List Thermostats

Returns a list of thermostats connected to your workspace. If no thermostats are connected, the list will be empty.

/thermostats/list

POSThttps://connect.getseam.com/thermostats/list
Authorization
Body
connected_account_idstring (uuid)

List all devices owned by this connected account

connected_account_idsarray of string (uuid)
connect_webview_idstring (uuid)
device_typeone of
device_typesarray of one of
manufacturerenum
akuvoxaugustavigilon_altabrivobutterflymxdoorkingfour_suitesgenieiglookeywekwiksetlinearlocklynukiphiliasaltosamsungschlageseamunknownwyzeyaleminuttwo_nttlocknestigloohomeecobeehubitatcontrolbywebsmartthingsdormakaba_oracodetedeehoneywell_resideo
device_idsarray of string (uuid)
limitnumber (float)
created_beforestring (date-time)
user_identifier_keystring
custom_metadata_hasobject
include_ifarray of enum
exclude_ifarray of enum
Response

OK

Body
thermostats*array of device (object)
ok*boolean
Request
const response = await fetch('https://connect.getseam.com/thermostats/list', {
    method: 'POST',
    headers: {
      "Authorization": "Bearer API Key",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();
Response
{
  "thermostats": [
    {
      "device_id": "123e4567-e89b-12d3-a456-426614174000",
      "device_type": "akuvox_lock",
      "nickname": "text",
      "display_name": "text",
      "capabilities_supported": [
        "access_code"
      ],
      "properties": {
        "online": false,
        "accessory_keypad": {
          "is_connected": false,
          "battery": {
            "level": 0
          }
        },
        "appearance": {
          "name": "text"
        },
        "model": {
          "can_connect_accessory_keypad": false,
          "display_name": "text",
          "manufacturer_display_name": "text",
          "has_built_in_keypad": false,
          "offline_access_codes_supported": false,
          "online_access_codes_supported": false
        },
        "has_direct_power": false,
        "battery_level": 0,
        "battery": {
          "level": 0,
          "status": "critical"
        },
        "manufacturer": "text",
        "image_url": "https://example.com",
        "image_alt_text": "text",
        "serial_number": "text",
        "online_access_codes_enabled": false,
        "offline_access_codes_enabled": false,
        "noise_level_decibels": 0,
        "currently_triggering_noise_threshold_ids": [
          "text"
        ],
        "assa_abloy_credential_service_metadata": {
          "has_active_endpoint": false,
          "endpoints": [
            {
              "endpoint_id": "text",
              "is_active": false
            }
          ]
        },
        "august_metadata": {
          "lock_id": "text",
          "lock_name": "text",
          "house_name": "text",
          "has_keypad": false,
          "keypad_battery_level": "text",
          "model": "text",
          "house_id": "text"
        },
        "avigilon_alta_metadata": {
          "entry_name": "text",
          "org_name": "text",
          "zone_id": 0,
          "zone_name": "text",
          "site_id": 0,
          "site_name": "text",
          "entry_relays_total_count": 0
        },
        "schlage_metadata": {
          "device_id": "text",
          "device_name": "text",
          "access_code_length": 0,
          "model": "text"
        },
        "smartthings_metadata": {
          "device_id": "text",
          "device_name": "text",
          "model": "text",
          "location_id": "text"
        },
        "lockly_metadata": {
          "device_id": "text",
          "device_name": "text",
          "model": "text"
        },
        "nuki_metadata": {
          "device_id": "text",
          "device_name": "text",
          "keypad_battery_critical": false,
          "keypad_paired": false,
          "keypad_2_paired": false
        },
        "kwikset_metadata": {
          "device_id": "text",
          "device_name": "text",
          "model_number": "text"
        },
        "salto_metadata": {
          "lock_id": "text",
          "customer_reference": "text",
          "lock_type": "text",
          "battery_level": "text",
          "locked_state": "text",
          "model": "text"
        },
        "genie_metadata": {
          "device_name": "text",
          "door_name": "text"
        },
        "brivo_metadata": {
          "device_name": "text"
        },
        "igloo_metadata": {
          "device_id": "text",
          "bridge_id": "text",
          "model": "text"
        },
        "noiseaware_metadata": {
          "device_model": "indoor",
          "noise_level_nrs": 0,
          "noise_level_decibel": 0,
          "device_name": "text",
          "device_id": "text"
        },
        "minut_metadata": {
          "device_id": "text",
          "device_name": "text",
          "latest_sensor_values": {
            "temperature": {
              "time": "text",
              "value": 0
            },
            "sound": {
              "time": "text",
              "value": 0
            },
            "humidity": {
              "time": "text",
              "value": 0
            },
            "pressure": {
              "time": "text",
              "value": 0
            },
            "accelerometer_z": {
              "time": "text",
              "value": 0
            }
          }
        },
        "four_suites_metadata": {
          "device_id": 0,
          "device_name": "text",
          "reclose_delay_in_seconds": 0
        },
        "two_n_metadata": {
          "device_id": 0,
          "device_name": "text"
        },
        "controlbyweb_metadata": {
          "device_id": "text",
          "device_name": "text",
          "relay_name": "text"
        },
        "ttlock_metadata": {
          "lock_id": 0,
          "lock_alias": "text",
          "feature_value": "text"
        },
        "seam_bridge_metadata": {
          "unlock_method": "bridge",
          "device_num": 0,
          "name": "text"
        },
        "igloohome_metadata": {
          "device_id": "text",
          "device_name": "text",
          "bridge_id": "text",
          "bridge_name": "text",
          "keypad_id": "text"
        },
        "nest_metadata": {
          "nest_device_id": "text",
          "device_name": "text",
          "custom_name": "text"
        },
        "ecobee_metadata": {
          "ecobee_device_id": "text",
          "device_name": "text"
        },
        "honeywell_resideo_metadata": {
          "honeywell_resideo_device_id": "text",
          "device_name": "text"
        },
        "hubitat_metadata": {
          "device_id": "text",
          "device_name": "text",
          "device_label": "text"
        },
        "dormakaba_oracode_metadata": {
          "door_id": 0,
          "door_name": "text",
          "device_id": 0,
          "door_is_wireless": false,
          "site_id": 0,
          "site_name": "text",
          "iana_timezone": "text",
          "predefined_time_slots": [
            {
              "name": "text",
              "prefix": 0,
              "check_in_time": "text",
              "check_out_time": "text",
              "is_24_hour": false,
              "is_biweekly_mode": false,
              "is_one_shot": false,
              "is_master": false,
              "ext_dormakaba_oracode_user_level_prefix": 0,
              "dormakaba_oracode_user_level_id": "123e4567-e89b-12d3-a456-426614174000"
            }
          ]
        },
        "wyze_metadata": {
          "device_id": "text",
          "device_name": "text",
          "product_name": "text",
          "product_type": "text",
          "product_model": "text",
          "device_info_model": "text",
          "keypad_uuid": "text",
          "locker_status_hardlock": 0
        },
        "tedee_metadata": {
          "device_id": 0,
          "serial_number": "text",
          "device_name": "text",
          "device_model": "text",
          "bridge_id": 0,
          "bridge_name": "text",
          "keypad_id": 0
        },
        "_experimental_supported_code_from_access_codes_lengths": [
          0
        ],
        "code_constraints": [
          {
            "constraint_type": "no_zeros"
          }
        ],
        "supported_code_lengths": [
          0
        ],
        "max_active_codes_supported": 0,
        "supports_backup_access_code_pool": false,
        "has_native_entry_events": false,
        "locked": false,
        "keypad_battery": {
          "level": 0
        },
        "door_open": false,
        "temperature_fahrenheit": 0,
        "temperature_celsius": 0,
        "relative_humidity": 0,
        "available_hvac_mode_settings": [
          "off"
        ],
        "is_heating": false,
        "is_cooling": false,
        "is_fan_running": false,
        "fan_mode_setting": "auto",
        "is_temporary_manual_override_active": false,
        "current_climate_setting": {
          "hvac_mode_setting": "off",
          "cooling_set_point_celsius": 0,
          "heating_set_point_celsius": 0,
          "cooling_set_point_fahrenheit": 0,
          "heating_set_point_fahrenheit": 0,
          "manual_override_allowed": false
        },
        "default_climate_setting": {
          "hvac_mode_setting": "off",
          "cooling_set_point_celsius": 0,
          "heating_set_point_celsius": 0,
          "cooling_set_point_fahrenheit": 0,
          "heating_set_point_fahrenheit": 0,
          "manual_override_allowed": false
        },
        "is_climate_setting_schedule_active": false,
        "active_climate_setting_schedule": {
          "climate_setting_schedule_id": "123e4567-e89b-12d3-a456-426614174000",
          "schedule_type": "time_bound",
          "device_id": "123e4567-e89b-12d3-a456-426614174000",
          "name": "text",
          "schedule_starts_at": "text",
          "schedule_ends_at": "text",
          "created_at": "2024-09-10T04:56:54.555Z",
          "hvac_mode_setting": "off",
          "cooling_set_point_celsius": 0,
          "heating_set_point_celsius": 0,
          "cooling_set_point_fahrenheit": 0,
          "heating_set_point_fahrenheit": 0,
          "manual_override_allowed": false
        },
        "min_cooling_set_point_celsius": 0,
        "min_cooling_set_point_fahrenheit": 0,
        "max_cooling_set_point_celsius": 0,
        "max_cooling_set_point_fahrenheit": 0,
        "min_heating_set_point_celsius": 0,
        "min_heating_set_point_fahrenheit": 0,
        "max_heating_set_point_celsius": 0,
        "max_heating_set_point_fahrenheit": 0,
        "min_heating_cooling_delta_celsius": 0,
        "min_heating_cooling_delta_fahrenheit": 0
      },
      "location": {
        "location_name": "text",
        "timezone": "text"
      },
      "connected_account_id": "123e4567-e89b-12d3-a456-426614174000",
      "workspace_id": "123e4567-e89b-12d3-a456-426614174000",
      "errors": [
        {
          "message": "text",
          "is_device_error": true,
          "error_code": "text"
        }
      ],
      "warnings": [
        {
          "message": "text",
          "warning_code": "text"
        }
      ],
      "created_at": "2024-09-10T04:56:54.555Z",
      "is_managed": true,
      "can_remotely_unlock": false,
      "can_remotely_lock": false,
      "can_program_offline_access_codes": false,
      "can_program_online_access_codes": false,
      "can_hvac_heat": false,
      "can_hvac_cool": false,
      "can_hvac_heat_cool": false,
      "can_turn_off_hvac": false,
      "can_simulate_removal": false,
      "can_simulate_connection": false,
      "can_simulate_disconnection": false
    }
  ],
  "ok": false
}

Code Example

seam.thermostats.list()

# [
#     {
#       "device_id": "a83690b2-2b70-409a-9a94-426699b84c97",
#       "device_type": "ecobee_thermostat",
#       "capabilities_supported": ["thermostat"],
#       "properties": {
#         "name": "Entryway",
#         "online": true,
#         "relative_humidity": 0.36,
#         "temperature_fahrenheit": 70,
#         "available_hvac_mode_settings": [
#           "cool",
#           "heat",
#           "heat_cool",
#           "off"
#         ],
#         "current_climate_setting": {
#           "hvac_mode_setting": "heat_cool",
#           "cooling_set_point_fahrenheit": 75,
#           "heating_set_point_fahrenheit": 65,
#           "manual_override_allowed": false 
#         }
#       },
#       "location": null,
#       "connected_account_id": "b0be0837-29c2-4cb1-8560-42dfd07fb877",
#       "workspace_id": "f97073eb-c003-467a-965b-e6dba3a0131d",
#       "created_at": "2023-06-01T11:14:37.116Z",
#       "errors": []
#     },
#     {
#       "device_id": "a3f30bd2-f6d7-4bad-ba89-1bad3bf1bce4",
#       "device_type": "ecobee_thermostat",
#       "capabilities_supported": ["thermostat"],
#       "properties": {
#         "name": "Entryway",
#         "online": true,
#         "relative_humidity": 0.36,
#         "temperature_fahrenheit": 70,
#         "available_hvac_mode_settings": [
#           "cool",
#           "heat",
#           "heat_cool",
#           "off"
#         ],
#         "current_climate_setting": {
#           "hvac_mode_setting": "heat_cool",
#           "cooling_set_point_fahrenheit": 75,
#           "heating_set_point_fahrenheit": 65,
#           "manual_override_allowed": false 
#         }
#       },
#       "location": null,
#       "connected_account_id": "b0be0837-29c2-4cb1-8560-42dfd07fb877",
#       "workspace_id": "f97073eb-c003-467a-965b-e6dba3a0131d",
#       "created_at": "2023-06-01T11:14:37.116Z",
#       "errors": []
#     }
#   ]

Request Body Parameters

ParameterTypeDescription

connected_account_id

String Optional

ID of the connected account to which the thermostats belong

connected_account_ids

Array<string> Optional

IDs of the connected accounts to which the thermostats belong

connect_webview_id

String Optional

ID of the Connect Webview that connected the thermostats to Seam

device_type

String Optional

Account type of the thermostats

workspace_id

String Optional

ID of the workspace

manufacturer

String Optional

Manufacturer name

device_ids

Array<string> Optional

Device IDs of the thermostats

user_identifier_key

String Optional

Your own internal user ID for the user by which to filter thermostats

Response

This section shows the JSON response returned by the API. Since each language encapsulates this response inside objects specific to that language and/or implementation, the actual type in your language might differ from what’s written here.

JSON format

{
  "thermostats": [
    {
      "device_id": "a83690b2-2b70-409a-9a94-426699b84c97",
      "device_type": "ecobee_thermostat",
      "capabilities_supported": ["thermostat"],
      "properties": {
        "name": "Entryway",
        "online": true,
        "relative_humidity": 0.36,
        "temperature_fahrenheit": 70,
        "available_hvac_mode_settings": [
          "cool",
          "heat",
          "heat_cool",
          "off"
        ],
        "current_climate_setting": {
          "hvac_mode_setting": "heat_cool",
          "cooling_set_point_fahrenheit": 75,
          "heating_set_point_fahrenheit": 65,
          "manual_override_allowed": false 
        }
      },
      "location": null,
      "connected_account_id": "b0be0837-29c2-4cb1-8560-42dfd07fb877",
      "workspace_id": "f97073eb-c003-467a-965b-e6dba3a0131d",
      "created_at": "2023-06-01T11:14:37.116Z",
      "errors": []
    },
    {
      "device_id": "a3f30bd2-f6d7-4bad-ba89-1bad3bf1bce4",
      "device_type": "ecobee_thermostat",
      "capabilities_supported": ["thermostat"],
      "properties": {
        "name": "Entryway",
        "online": true,
        "relative_humidity": 0.36,
        "temperature_fahrenheit": 70,
        "available_hvac_mode_settings": [
          "cool",
          "heat",
          "heat_cool",
          "off"
        ],
        "current_climate_setting": {
          "hvac_mode_setting": "heat_cool",
          "cooling_set_point_fahrenheit": 75,
          "heating_set_point_fahrenheit": 65,
          "manual_override_allowed": false 
        }
      },
      "location": null,
      "connected_account_id": "b0be0837-29c2-4cb1-8560-42dfd07fb877",
      "workspace_id": "f97073eb-c003-467a-965b-e6dba3a0131d",
      "created_at": "2023-06-01T11:14:37.116Z",
      "errors": []
    }
  ],
  "ok": true
}
PreviousThermostatsNextGet a Thermostat

Last updated

Logo

Resources

Sign-UpBlogAboutSupported Devices

© Seam Labs, Inc. All rights reserved.