List Thermostats

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

/thermostats/list

post

Returns a list of all thermostats.

Authorizations

api_keypat_with_workspaceconsole_session_with_workspaceclient_session

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

customer_keystringOptional

Customer key for which you want to list devices.

connected_account_idstring · uuidOptional

ID of the connected account for which you want to list devices.

connected_account_idsstring · uuid[]Optional

Array of IDs of the connected accounts for which you want to list devices.

connect_webview_idstring · uuidOptional

ID of the Connect Webview for which you want to list devices.

device_typestring · enumOptional

Device type by which you want to filter thermostat devices.

Possible values:

manufacturerstring · enumOptional

Manufacturer by which you want to filter thermostat devices.

Possible values:

device_idsstring · uuid[]Optional

Array of device IDs for which you want to list devices.

limitnumber · floatOptional

Numerical limit on the number of devices to return.

Default: 500

created_beforestring · date-timeOptional

Timestamp by which to limit returned devices. Returns devices created before this timestamp.

user_identifier_keystringOptional

Your own internal user ID for the user for which you want to list devices.

page_cursorstring | nullableOptional

Identifies the specific page of results to return, obtained from the previous page's next_page_cursor.

unstable_location_idstring · uuid | nullableOptionalDeprecated

space_idstring · uuidOptional

ID of the space for which you want to list devices.

searchstring · min: 1Optional

String for which to search. Filters returned devices to include all records that satisfy a partial match using device_id, display_name, custom_metadata or location.location_name.

Responses

200

OK

application/json

400

Bad Request

401

Unauthorized

post

/thermostats/list

HTTPcURLJavaScriptPython

POST /thermostats/list HTTP/1.1
Host: connect.getseam.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 662

{
  "customer_key": "text",
  "connected_account_id": "123e4567-e89b-12d3-a456-426614174000",
  "connected_account_ids": [
    "123e4567-e89b-12d3-a456-426614174000"
  ],
  "connect_webview_id": "123e4567-e89b-12d3-a456-426614174000",
  "device_type": "ecobee_thermostat",
  "device_types": [
    "ecobee_thermostat"
  ],
  "manufacturer": "ecobee",
  "device_ids": [
    "123e4567-e89b-12d3-a456-426614174000"
  ],
  "limit": 500,
  "created_before": "2025-12-16T14:54:17.098Z",
  "user_identifier_key": "text",
  "custom_metadata_has": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  },
  "page_cursor": "text",
  "include_if": [
    "can_remotely_unlock"
  ],
  "exclude_if": [
    "can_remotely_unlock"
  ],
  "space_id": "123e4567-e89b-12d3-a456-426614174000",
  "search": "text"
}

{
  "thermostats": [
    {
      "device_id": "123e4567-e89b-12d3-a456-426614174000",
      "device_type": "akuvox_lock",
      "space_ids": [
        "123e4567-e89b-12d3-a456-426614174000"
      ],
      "nickname": "text",
      "display_name": "text",
      "capabilities_supported": [
        "access_code"
      ],
      "properties": {
        "online": true,
        "accessory_keypad": {
          "is_connected": true,
          "battery": {
            "level": 1
          }
        },
        "appearance": {
          "name": "text"
        },
        "model": {
          "can_connect_accessory_keypad": true,
          "display_name": "text",
          "manufacturer_display_name": "text",
          "has_built_in_keypad": true
        },
        "has_direct_power": true,
        "battery_level": 1,
        "battery": {
          "level": 1,
          "status": "critical"
        },
        "manufacturer": "text",
        "image_url": "https://example.com",
        "image_alt_text": "text",
        "serial_number": "text",
        "noise_level_decibels": 1,
        "currently_triggering_noise_threshold_ids": [
          "text"
        ],
        "assa_abloy_credential_service_metadata": {
          "has_active_endpoint": true,
          "endpoints": [
            {
              "endpoint_id": "text",
              "is_active": true
            }
          ]
        },
        "salto_space_credential_service_metadata": {
          "has_active_phone": true
        },
        "august_metadata": {
          "lock_id": "text",
          "lock_name": "text",
          "house_name": "text",
          "has_keypad": true,
          "keypad_battery_level": "text",
          "model": "text",
          "house_id": "text"
        },
        "avigilon_alta_metadata": {
          "entry_name": "text",
          "org_name": "text",
          "zone_id": 1,
          "zone_name": "text",
          "site_id": 1,
          "site_name": "text",
          "entry_relays_total_count": 1
        },
        "schlage_metadata": {
          "device_id": "text",
          "device_name": "text",
          "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": true,
          "keypad_paired": true,
          "keypad_2_paired": true
        },
        "kwikset_metadata": {
          "device_id": "text",
          "device_name": "text",
          "model_number": "text"
        },
        "salto_ks_metadata": {
          "lock_id": "text",
          "customer_reference": "text",
          "lock_type": "text",
          "battery_level": "text",
          "locked_state": "text",
          "model": "text",
          "has_custom_pin_subscription": true
        },
        "genie_metadata": {
          "device_name": "text",
          "door_name": "text"
        },
        "brivo_metadata": {
          "device_name": "text",
          "activation_enabled": true
        },
        "igloo_metadata": {
          "device_id": "text",
          "bridge_id": "text",
          "model": "text"
        },
        "noiseaware_metadata": {
          "device_model": "indoor",
          "noise_level_nrs": 1,
          "noise_level_decibel": 1,
          "device_name": "text",
          "device_id": "text"
        },
        "minut_metadata": {
          "device_id": "text",
          "device_name": "text",
          "latest_sensor_values": {
            "temperature": {
              "time": "text",
              "value": 1
            },
            "sound": {
              "time": "text",
              "value": 1
            },
            "humidity": {
              "time": "text",
              "value": 1
            },
            "pressure": {
              "time": "text",
              "value": 1
            },
            "accelerometer_z": {
              "time": "text",
              "value": 1
            }
          }
        },
        "four_suites_metadata": {
          "device_id": 1,
          "device_name": "text",
          "reclose_delay_in_seconds": 1
        },
        "two_n_metadata": {
          "device_id": 1,
          "device_name": "text"
        },
        "controlbyweb_metadata": {
          "device_id": "text",
          "device_name": "text",
          "relay_name": "text"
        },
        "ttlock_metadata": {
          "lock_id": 1,
          "lock_alias": "text",
          "feature_value": "text",
          "features": {
            "passcode": true,
            "passcode_management": true,
            "unlock_via_gateway": true,
            "lock_command": true,
            "incomplete_keyboard_passcode": true,
            "wifi": true
          },
          "has_gateway": true,
          "wireless_keypads": [
            {
              "wireless_keypad_id": 1,
              "wireless_keypad_name": "text"
            }
          ]
        },
        "seam_bridge_metadata": {
          "unlock_method": "bridge",
          "device_num": 1,
          "name": "text"
        },
        "igloohome_metadata": {
          "device_id": "text",
          "device_name": "text",
          "bridge_id": "text",
          "bridge_name": "text",
          "keypad_id": "text",
          "is_keypad_linked_to_bridge": true
        },
        "nest_metadata": {
          "nest_device_id": "text",
          "device_name": "text",
          "device_custom_name": "text",
          "display_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": 1,
          "door_name": "text",
          "device_id": 1,
          "door_is_wireless": true,
          "site_name": "text",
          "iana_timezone": "text",
          "predefined_time_slots": [
            {
              "name": "text",
              "prefix": 1,
              "check_in_time": "text",
              "check_out_time": "text",
              "is_24_hour": true,
              "is_biweekly_mode": true,
              "is_one_shot": true,
              "is_master": true,
              "ext_dormakaba_oracode_user_level_prefix": 1,
              "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": 1
        },
        "tedee_metadata": {
          "device_id": 1,
          "serial_number": "text",
          "device_name": "text",
          "device_model": "text",
          "bridge_id": 1,
          "bridge_name": "text",
          "keypad_id": 1
        },
        "visionline_metadata": {
          "encoder_id": "text"
        },
        "akiles_metadata": {
          "gadget_name": "text",
          "gadget_id": "text",
          "product_name": "text",
          "_member_group_id": "text"
        },
        "assa_abloy_vostio_metadata": {
          "encoder_name": "text"
        },
        "tado_metadata": {
          "serial_no": "text",
          "device_type": "text"
        },
        "sensi_metadata": {
          "device_id": "text",
          "device_name": "text",
          "product_type": "text"
        },
        "keynest_metadata": {
          "key_id": "text",
          "device_name": "text",
          "property_id": "text",
          "property_postcode": "text",
          "key_notes": "text",
          "subscription_plan": "text",
          "status_type": "text",
          "current_or_last_store_id": 1,
          "last_movement": "text",
          "address": "text",
          "current_status": "text",
          "current_user_name": "text",
          "current_user_email": "text",
          "current_user_phone_number": "text",
          "current_user_company": "text",
          "handover_method": "text",
          "keynest_app_user": "text",
          "default_office_id": 1,
          "fob_id": 1,
          "has_photo": true,
          "is_quadient_locker": true
        },
        "ultraloq_metadata": {
          "device_id": "text",
          "device_name": "text",
          "device_type": "text",
          "time_zone": "text"
        },
        "_experimental_supported_code_from_access_codes_lengths": [
          1
        ],
        "code_constraints": [
          {
            "constraint_type": "no_zeros"
          }
        ],
        "supported_code_lengths": [
          1
        ],
        "max_active_codes_supported": 1,
        "supports_backup_access_code_pool": true,
        "has_native_entry_events": true,
        "locked": true,
        "keypad_battery": {
          "level": 1
        },
        "door_open": true,
        "temperature_fahrenheit": 1,
        "temperature_celsius": 1,
        "relative_humidity": 1,
        "available_hvac_mode_settings": [
          "off"
        ],
        "available_fan_mode_settings": [
          "auto"
        ],
        "available_climate_preset_modes": [
          "home"
        ],
        "is_heating": true,
        "is_cooling": true,
        "is_fan_running": true,
        "is_temporary_manual_override_active": true,
        "current_climate_setting": {
          "climate_preset_key": "text",
          "can_edit": true,
          "can_delete": true,
          "can_use_with_thermostat_daily_programs": true,
          "name": "text",
          "display_name": "text",
          "climate_preset_mode": "home",
          "fan_mode_setting": "auto",
          "hvac_mode_setting": "off",
          "cooling_set_point_celsius": 1,
          "heating_set_point_celsius": 1,
          "cooling_set_point_fahrenheit": 1,
          "heating_set_point_fahrenheit": 1,
          "ecobee_metadata": {
            "climate_ref": "text",
            "is_optimized": true,
            "owner": "user"
          }
        },
        "available_climate_presets": [
          {
            "climate_preset_key": "text",
            "can_edit": true,
            "can_delete": true,
            "can_use_with_thermostat_daily_programs": true,
            "name": "text",
            "display_name": "text",
            "climate_preset_mode": "home",
            "fan_mode_setting": "auto",
            "hvac_mode_setting": "off",
            "cooling_set_point_celsius": 1,
            "heating_set_point_celsius": 1,
            "cooling_set_point_fahrenheit": 1,
            "heating_set_point_fahrenheit": 1,
            "ecobee_metadata": {
              "climate_ref": "text",
              "is_optimized": true,
              "owner": "user"
            }
          }
        ],
        "fallback_climate_preset_key": "text",
        "active_thermostat_schedule_id": "123e4567-e89b-12d3-a456-426614174000",
        "thermostat_daily_programs": [
          {
            "thermostat_daily_program_id": "123e4567-e89b-12d3-a456-426614174000",
            "device_id": "123e4567-e89b-12d3-a456-426614174000",
            "name": "text",
            "periods": [
              {
                "starts_at_time": "text",
                "climate_preset_key": "text"
              }
            ],
            "workspace_id": "123e4567-e89b-12d3-a456-426614174000",
            "created_at": "2025-12-16T14:54:17.098Z"
          }
        ],
        "thermostat_weekly_program": {
          "monday_program_id": "123e4567-e89b-12d3-a456-426614174000",
          "tuesday_program_id": "123e4567-e89b-12d3-a456-426614174000",
          "wednesday_program_id": "123e4567-e89b-12d3-a456-426614174000",
          "thursday_program_id": "123e4567-e89b-12d3-a456-426614174000",
          "friday_program_id": "123e4567-e89b-12d3-a456-426614174000",
          "saturday_program_id": "123e4567-e89b-12d3-a456-426614174000",
          "sunday_program_id": "123e4567-e89b-12d3-a456-426614174000",
          "created_at": "2025-12-16T14:54:17.098Z"
        },
        "min_cooling_set_point_celsius": 1,
        "min_cooling_set_point_fahrenheit": 1,
        "max_cooling_set_point_celsius": 1,
        "max_cooling_set_point_fahrenheit": 1,
        "min_heating_set_point_celsius": 1,
        "min_heating_set_point_fahrenheit": 1,
        "max_heating_set_point_celsius": 1,
        "max_heating_set_point_fahrenheit": 1,
        "min_heating_cooling_delta_celsius": 1,
        "min_heating_cooling_delta_fahrenheit": 1,
        "temperature_threshold": {
          "lower_limit_celsius": 1,
          "lower_limit_fahrenheit": 1,
          "upper_limit_celsius": 1,
          "upper_limit_fahrenheit": 1
        },
        "thermostat_daily_program_period_precision_minutes": 1,
        "max_unique_climate_presets_per_thermostat_weekly_program": 1,
        "max_thermostat_daily_program_periods_per_day": 1
      },
      "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": false,
          "created_at": "2025-12-16T14:54:17.098Z",
          "error_code": "account_disconnected",
          "is_connected_account_error": true
        }
      ],
      "warnings": [
        {
          "message": "text",
          "created_at": "2025-12-16T14:54:17.098Z",
          "warning_code": "partial_backup_access_code_pool"
        }
      ],
      "created_at": "2025-12-16T14:54:17.098Z",
      "is_managed": true,
      "custom_metadata": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      },
      "can_remotely_unlock": true,
      "can_remotely_lock": true,
      "can_program_offline_access_codes": true,
      "can_program_online_access_codes": true,
      "can_hvac_heat": true,
      "can_hvac_cool": true,
      "can_hvac_heat_cool": true,
      "can_turn_off_hvac": true,
      "can_simulate_removal": true,
      "can_simulate_connection": true,
      "can_simulate_disconnection": true,
      "can_unlock_with_code": true,
      "can_run_thermostat_programs": true,
      "can_program_thermostat_programs_as_weekday_weekend": true,
      "can_program_thermostat_programs_as_different_each_day": true,
      "can_program_thermostat_programs_as_same_each_day": true,
      "can_simulate_hub_connection": true,
      "can_simulate_hub_disconnection": true,
      "can_simulate_paid_subscription": true
    }
  ],
  "devices": [
    {
      "device_id": "123e4567-e89b-12d3-a456-426614174000",
      "device_type": "akuvox_lock",
      "space_ids": [
        "123e4567-e89b-12d3-a456-426614174000"
      ],
      "nickname": "text",
      "display_name": "text",
      "capabilities_supported": [
        "access_code"
      ],
      "properties": {
        "online": true,
        "accessory_keypad": {
          "is_connected": true,
          "battery": {
            "level": 1
          }
        },
        "appearance": {
          "name": "text"
        },
        "model": {
          "can_connect_accessory_keypad": true,
          "display_name": "text",
          "manufacturer_display_name": "text",
          "has_built_in_keypad": true
        },
        "has_direct_power": true,
        "battery_level": 1,
        "battery": {
          "level": 1,
          "status": "critical"
        },
        "manufacturer": "text",
        "image_url": "https://example.com",
        "image_alt_text": "text",
        "serial_number": "text",
        "noise_level_decibels": 1,
        "currently_triggering_noise_threshold_ids": [
          "text"
        ],
        "assa_abloy_credential_service_metadata": {
          "has_active_endpoint": true,
          "endpoints": [
            {
              "endpoint_id": "text",
              "is_active": true
            }
          ]
        },
        "salto_space_credential_service_metadata": {
          "has_active_phone": true
        },
        "august_metadata": {
          "lock_id": "text",
          "lock_name": "text",
          "house_name": "text",
          "has_keypad": true,
          "keypad_battery_level": "text",
          "model": "text",
          "house_id": "text"
        },
        "avigilon_alta_metadata": {
          "entry_name": "text",
          "org_name": "text",
          "zone_id": 1,
          "zone_name": "text",
          "site_id": 1,
          "site_name": "text",
          "entry_relays_total_count": 1
        },
        "schlage_metadata": {
          "device_id": "text",
          "device_name": "text",
          "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": true,
          "keypad_paired": true,
          "keypad_2_paired": true
        },
        "kwikset_metadata": {
          "device_id": "text",
          "device_name": "text",
          "model_number": "text"
        },
        "salto_ks_metadata": {
          "lock_id": "text",
          "customer_reference": "text",
          "lock_type": "text",
          "battery_level": "text",
          "locked_state": "text",
          "model": "text",
          "has_custom_pin_subscription": true
        },
        "genie_metadata": {
          "device_name": "text",
          "door_name": "text"
        },
        "brivo_metadata": {
          "device_name": "text",
          "activation_enabled": true
        },
        "igloo_metadata": {
          "device_id": "text",
          "bridge_id": "text",
          "model": "text"
        },
        "noiseaware_metadata": {
          "device_model": "indoor",
          "noise_level_nrs": 1,
          "noise_level_decibel": 1,
          "device_name": "text",
          "device_id": "text"
        },
        "minut_metadata": {
          "device_id": "text",
          "device_name": "text",
          "latest_sensor_values": {
            "temperature": {
              "time": "text",
              "value": 1
            },
            "sound": {
              "time": "text",
              "value": 1
            },
            "humidity": {
              "time": "text",
              "value": 1
            },
            "pressure": {
              "time": "text",
              "value": 1
            },
            "accelerometer_z": {
              "time": "text",
              "value": 1
            }
          }
        },
        "four_suites_metadata": {
          "device_id": 1,
          "device_name": "text",
          "reclose_delay_in_seconds": 1
        },
        "two_n_metadata": {
          "device_id": 1,
          "device_name": "text"
        },
        "controlbyweb_metadata": {
          "device_id": "text",
          "device_name": "text",
          "relay_name": "text"
        },
        "ttlock_metadata": {
          "lock_id": 1,
          "lock_alias": "text",
          "feature_value": "text",
          "features": {
            "passcode": true,
            "passcode_management": true,
            "unlock_via_gateway": true,
            "lock_command": true,
            "incomplete_keyboard_passcode": true,
            "wifi": true
          },
          "has_gateway": true,
          "wireless_keypads": [
            {
              "wireless_keypad_id": 1,
              "wireless_keypad_name": "text"
            }
          ]
        },
        "seam_bridge_metadata": {
          "unlock_method": "bridge",
          "device_num": 1,
          "name": "text"
        },
        "igloohome_metadata": {
          "device_id": "text",
          "device_name": "text",
          "bridge_id": "text",
          "bridge_name": "text",
          "keypad_id": "text",
          "is_keypad_linked_to_bridge": true
        },
        "nest_metadata": {
          "nest_device_id": "text",
          "device_name": "text",
          "device_custom_name": "text",
          "display_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": 1,
          "door_name": "text",
          "device_id": 1,
          "door_is_wireless": true,
          "site_name": "text",
          "iana_timezone": "text",
          "predefined_time_slots": [
            {
              "name": "text",
              "prefix": 1,
              "check_in_time": "text",
              "check_out_time": "text",
              "is_24_hour": true,
              "is_biweekly_mode": true,
              "is_one_shot": true,
              "is_master": true,
              "ext_dormakaba_oracode_user_level_prefix": 1,
              "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": 1
        },
        "tedee_metadata": {
          "device_id": 1,
          "serial_number": "text",
          "device_name": "text",
          "device_model": "text",
          "bridge_id": 1,
          "bridge_name": "text",
          "keypad_id": 1
        },
        "visionline_metadata": {
          "encoder_id": "text"
        },
        "akiles_metadata": {
          "gadget_name": "text",
          "gadget_id": "text",
          "product_name": "text",
          "_member_group_id": "text"
        },
        "assa_abloy_vostio_metadata": {
          "encoder_name": "text"
        },
        "tado_metadata": {
          "serial_no": "text",
          "device_type": "text"
        },
        "sensi_metadata": {
          "device_id": "text",
          "device_name": "text",
          "product_type": "text"
        },
        "keynest_metadata": {
          "key_id": "text",
          "device_name": "text",
          "property_id": "text",
          "property_postcode": "text",
          "key_notes": "text",
          "subscription_plan": "text",
          "status_type": "text",
          "current_or_last_store_id": 1,
          "last_movement": "text",
          "address": "text",
          "current_status": "text",
          "current_user_name": "text",
          "current_user_email": "text",
          "current_user_phone_number": "text",
          "current_user_company": "text",
          "handover_method": "text",
          "keynest_app_user": "text",
          "default_office_id": 1,
          "fob_id": 1,
          "has_photo": true,
          "is_quadient_locker": true
        },
        "ultraloq_metadata": {
          "device_id": "text",
          "device_name": "text",
          "device_type": "text",
          "time_zone": "text"
        },
        "_experimental_supported_code_from_access_codes_lengths": [
          1
        ],
        "code_constraints": [
          {
            "constraint_type": "no_zeros"
          }
        ],
        "supported_code_lengths": [
          1
        ],
        "max_active_codes_supported": 1,
        "supports_backup_access_code_pool": true,
        "has_native_entry_events": true,
        "locked": true,
        "keypad_battery": {
          "level": 1
        },
        "door_open": true,
        "temperature_fahrenheit": 1,
        "temperature_celsius": 1,
        "relative_humidity": 1,
        "available_hvac_mode_settings": [
          "off"
        ],
        "available_fan_mode_settings": [
          "auto"
        ],
        "available_climate_preset_modes": [
          "home"
        ],
        "is_heating": true,
        "is_cooling": true,
        "is_fan_running": true,
        "is_temporary_manual_override_active": true,
        "current_climate_setting": {
          "climate_preset_key": "text",
          "can_edit": true,
          "can_delete": true,
          "can_use_with_thermostat_daily_programs": true,
          "name": "text",
          "display_name": "text",
          "climate_preset_mode": "home",
          "fan_mode_setting": "auto",
          "hvac_mode_setting": "off",
          "cooling_set_point_celsius": 1,
          "heating_set_point_celsius": 1,
          "cooling_set_point_fahrenheit": 1,
          "heating_set_point_fahrenheit": 1,
          "ecobee_metadata": {
            "climate_ref": "text",
            "is_optimized": true,
            "owner": "user"
          }
        },
        "available_climate_presets": [
          {
            "climate_preset_key": "text",
            "can_edit": true,
            "can_delete": true,
            "can_use_with_thermostat_daily_programs": true,
            "name": "text",
            "display_name": "text",
            "climate_preset_mode": "home",
            "fan_mode_setting": "auto",
            "hvac_mode_setting": "off",
            "cooling_set_point_celsius": 1,
            "heating_set_point_celsius": 1,
            "cooling_set_point_fahrenheit": 1,
            "heating_set_point_fahrenheit": 1,
            "ecobee_metadata": {
              "climate_ref": "text",
              "is_optimized": true,
              "owner": "user"
            }
          }
        ],
        "fallback_climate_preset_key": "text",
        "active_thermostat_schedule_id": "123e4567-e89b-12d3-a456-426614174000",
        "thermostat_daily_programs": [
          {
            "thermostat_daily_program_id": "123e4567-e89b-12d3-a456-426614174000",
            "device_id": "123e4567-e89b-12d3-a456-426614174000",
            "name": "text",
            "periods": [
              {
                "starts_at_time": "text",
                "climate_preset_key": "text"
              }
            ],
            "workspace_id": "123e4567-e89b-12d3-a456-426614174000",
            "created_at": "2025-12-16T14:54:17.098Z"
          }
        ],
        "thermostat_weekly_program": {
          "monday_program_id": "123e4567-e89b-12d3-a456-426614174000",
          "tuesday_program_id": "123e4567-e89b-12d3-a456-426614174000",
          "wednesday_program_id": "123e4567-e89b-12d3-a456-426614174000",
          "thursday_program_id": "123e4567-e89b-12d3-a456-426614174000",
          "friday_program_id": "123e4567-e89b-12d3-a456-426614174000",
          "saturday_program_id": "123e4567-e89b-12d3-a456-426614174000",
          "sunday_program_id": "123e4567-e89b-12d3-a456-426614174000",
          "created_at": "2025-12-16T14:54:17.098Z"
        },
        "min_cooling_set_point_celsius": 1,
        "min_cooling_set_point_fahrenheit": 1,
        "max_cooling_set_point_celsius": 1,
        "max_cooling_set_point_fahrenheit": 1,
        "min_heating_set_point_celsius": 1,
        "min_heating_set_point_fahrenheit": 1,
        "max_heating_set_point_celsius": 1,
        "max_heating_set_point_fahrenheit": 1,
        "min_heating_cooling_delta_celsius": 1,
        "min_heating_cooling_delta_fahrenheit": 1,
        "temperature_threshold": {
          "lower_limit_celsius": 1,
          "lower_limit_fahrenheit": 1,
          "upper_limit_celsius": 1,
          "upper_limit_fahrenheit": 1
        },
        "thermostat_daily_program_period_precision_minutes": 1,
        "max_unique_climate_presets_per_thermostat_weekly_program": 1,
        "max_thermostat_daily_program_periods_per_day": 1
      },
      "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": false,
          "created_at": "2025-12-16T14:54:17.098Z",
          "error_code": "account_disconnected",
          "is_connected_account_error": true
        }
      ],
      "warnings": [
        {
          "message": "text",
          "created_at": "2025-12-16T14:54:17.098Z",
          "warning_code": "partial_backup_access_code_pool"
        }
      ],
      "created_at": "2025-12-16T14:54:17.098Z",
      "is_managed": true,
      "custom_metadata": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      },
      "can_remotely_unlock": true,
      "can_remotely_lock": true,
      "can_program_offline_access_codes": true,
      "can_program_online_access_codes": true,
      "can_hvac_heat": true,
      "can_hvac_cool": true,
      "can_hvac_heat_cool": true,
      "can_turn_off_hvac": true,
      "can_simulate_removal": true,
      "can_simulate_connection": true,
      "can_simulate_disconnection": true,
      "can_unlock_with_code": true,
      "can_run_thermostat_programs": true,
      "can_program_thermostat_programs_as_weekday_weekend": true,
      "can_program_thermostat_programs_as_different_each_day": true,
      "can_program_thermostat_programs_as_same_each_day": true,
      "can_simulate_hub_connection": true,
      "can_simulate_hub_disconnection": true,
      "can_simulate_paid_subscription": true
    }
  ],
  "ok": true
}

Code Example

Python

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": []
#     }
#   ]

Javascript

Request Body Parameters

Parameter	Type	Description
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
manufacturer	String Optional	ID of the workspace
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

JSON

{
  "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
}