Get a Thermostat
Retrieves the details of a thermostat.
Returns a specified thermostat. Deprecated: Will be removed. Use /devices/get instead.
Authorizations
Body
device_idstring · uuidOptional
ID of the thermostat device that you want to get.
namestringOptional
Name of the thermostat device that you want to retrieve.
Responses
200
OK
application/json
400
Bad Request
401
Unauthorized
post
POST /thermostats/get HTTP/1.1
Host: connect.getseam.com
Authorization: Bearer Client Session Token
Content-Type: application/json
Accept: */*
Content-Length: 66
{
"device_id": "123e4567-e89b-12d3-a456-426614174000",
"name": "text"
}{
"thermostat": {
"device_id": "123e4567-e89b-12d3-a456-426614174000",
"device_type": "akuvox_lock",
"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"
},
"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
},
"_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_program": 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_program": 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-09-13T08:06:41.237Z"
}
],
"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-09-13T08:06:41.237Z"
},
"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_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-09-13T08:06:41.237Z",
"error_code": "account_disconnected",
"is_connected_account_error": true
}
],
"warnings": [
{
"message": "text",
"created_at": "2025-09-13T08:06:41.237Z",
"warning_code": "partial_backup_access_code_pool"
}
],
"created_at": "2025-09-13T08:06:41.237Z",
"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_simulate_hub_connection": true,
"can_simulate_hub_disconnection": true,
"can_simulate_paid_subscription": true
},
"ok": true
}Code Example
from seam import Seam
seam = Seam()
device_id = "123e4567-e89b-12d3-a456-426614174000"
thermostat = seam.thermostats.get(device_id)
print(thermostat)
# Thermostat(
# device_id="123e4567-e89b-12d3-a456-426614174000",
# 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=None,
# connected_account_id="123e4567-e89b-12d3-a456-426614174001",
# workspace_id="123e4567-e89b-12d3-a456-426614174002",
# created_at="2023-06-01T11:14:37.116Z",
# errors=[]
# )Parameters
device_id
type: string
ID of the Device
name
type: string
Name of the Device
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
{
"thermostat": {
"device_id": "62bc78df-a2ad-4fc4-801f-1c22042149ab",
"device_type": "ecobee_thermostat",
"capabilities_supported": [
"thermostat"
],
"properties": {
"online": true,
"is_cooling": false,
"is_heating": false,
"manufacturer": "ecobee",
"is_fan_running": true,
"ecobee_metadata": {
"device_name": "Living Room",
"ecobee_device_id": "5aef77f2-0c23-4ab7-b837-dc14e6c7f6a3"
},
"has_direct_power": true,
"relative_humidity": 0.36,
"temperature_celsius": 21.11111111111111,
"temperature_fahrenheit": 70,
"current_climate_setting": {
"hvac_mode_setting": "off",
"manual_override_allowed": false,
},
"available_hvac_mode_settings": [
"off",
"cool",
"heat",
"heat_cool"
],
"max_cooling_set_point_celsius": 33.333333333333336,
"max_heating_set_point_celsius": 26.11111111111111,
"min_cooling_set_point_celsius": 18.333333333333336,
"min_heating_set_point_celsius": 7.222222222222222,
"min_heating_cooling_delta_celsius": 2.7777777777777777,
"is_temporary_manual_override_active": false,
"name": "mild faucet",
"model": {
"display_name": "Thermostat",
"manufacturer_display_name": "Ecobee"
},
"image_url": "https://connect.getseam.com/assets/images/devices/ecobee_3-lite_front.png",
"image_alt_text": "Ecobee 3 Lite Thermostat",
"min_heating_set_point_fahrenheit": 45,
"max_heating_set_point_fahrenheit": 79,
"min_cooling_set_point_fahrenheit": 65,
"max_cooling_set_point_fahrenheit": 92,
"min_heating_cooling_delta_fahrenheit": 5
},
"location": null,
"connected_account_id": "bd6a8926-206d-4030-bf14-ccb3ecd1cd3e",
"workspace_id": "9946a591-2da2-4558-9556-0cadf93f4040",
"created_at": "2023-08-29T06:00:00.042Z",
"errors": [],
"warnings": [],
"is_managed": true
},
"ok": true
}
{
"thermostat": {
"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": []
},
"ok": true
}Last updated
Was this helpful?