Thermostats

Devices that can regulate the temperature of a location, so that the location's temperature is maintained near a desired set point temperature.

Thermostat Properties

Property	Type	Description
temperature_fahrenheit	Number	Temperature, measured in Fahrenheit.
temperature_celsius	Number	Temperature, measured in Celsius.
relative_humidity	Number	Relative humidity, the amount of moisture in the air compared to the maximum amount of moisture the air can hold at a given temperature. It is a percentage expressed as a number between 0 and 1, inclusive.
available_hvac_mode_settings	Array of enums (strings)	A list of the available HVAC modes for the thermostat. Possible values: cool heat heat_cool off
current_climate_setting	Object	See Climate Setting Properties.

Climate Setting Properties

Property	Type	Description
hvac_mode_setting	Enum (string) Required	HVAC mode to which the thermostat is set. Possible values: cool heat heat_cool off
cooling_set_point_celsius	Number Optional	The cooling set point, measured in Celsius, if cooling is turned on. When the ambient temperature rises above this set point, cooling turns on.
heating_set_point_celsius	Number Optional	The heating set point, measured in Celsius, if heating is turned on. When the ambient temperature drops below this set point, heating turns on.
cooling_set_point_fahrenheit	Number Optional	The cooling set point, measured in Fahrenheit, if cooling is turned on. When the ambient temperature rises above this set point, cooling turns on.
heating_set_point_fahrenheit	Number Optional	The heating set point, measured in Fahrenheit, if heating is turned on. When the ambient temperature drops below this set point, heating turns on.
manual_override_enabled	Boolean Required	Indicates whether another user can use the thermostat or API to override this climate setting.

Climate Set Points

When heating is turned on, you will need to set a heating set point. When the ambient temperature drops below this set point, heating will turn on.

When cooling is turned on, you will need to set a cooling set point. When the ambient temperature rises above this set point, cooling will turn on.

When you have heat_cool turned on, where both heating and cooling systems are enabled, you will need to set heating and cooling set points. The cooling set point needs to be set to a temperature higher than that of the heating set point. On some systems, there might also be a minimum difference between the heating and cooling set points.

List of Methods

Get Thermostat

List Thermostats