# Retrieving Thermostats When you use the [`/thermostats/list`](https://docs.seam.co/latest/api/thermostats/list) and [`/devices/get`](https://docs.seam.co/latest/api/devices/get) endpoints to retrieve information about your connected thermostats, the Seam API returns the following categories of information:
CategoryDetails
Current conditionsCurrent temperature in Fahrenheit and Celsius, current relative humidity, and so on. This includes such properties as temperature_celsius, temperature_fahrenheit, is_cooling, is_heating, is_fan_running, relative_humidity
Current operational statusWhether the associated HVAC system is currently heating or cooling, whether the fan is currently running. These properties are named current_climate_setting and reflect what the thermostat is set to 'achieve'.
Available HVAC modes for the thermostatheat, cool, heat_cool, and off.
Available fan modes for the thermostaton, auto, and circulate.
Thermostat capability flags

Capabilities of the thermostat—at a granular level.

These capability flags include the following:

  • device.can_hvac_heat
  • device.can_hvac_cool
  • device.can_hvac_heat_cool
  • device.can_turn_off_hvac
Available climate presetsClimate presets that you can schedule on the thermostat.
Climate preset constraintsConstraints related to climate presets for the specific thermostat brand or model.
For example, a thermostat might have a minimum or maximum cooling or heating set point or a minimum delta between the cooling and heating set points.
## List All Thermostats To retrieve all [thermostats](/latest/capability-guides/thermostats.md), issue a [`/thermostats/list`](https://docs.seam.co/latest/api/thermostats/list) request. You can filter by a variety of criteria, including `connected_account_id`, `connect_webview_id`, `manufacturer`, `user_identifier_key`, and so on. The following example retrieves all Google Nest thermostats: {% tabs %} {% tab title="JavaScript" %} **Request:** ```javascript await seam.thermostats.list({ manufacturer: "nest" }); ``` **Response:** ```json [ { device_id: 'a4b775e3-feb2-4c6b-8e78-a73ec2d70b61', device_type: 'nest_thermostat', properties: { online: true, is_cooling: false, is_heating: false, manufacturer: 'nest', is_fan_running: false, relative_humidity: 0.46, temperature_celsius: 24.64, temperature_fahrenheit: 76.352, available_hvac_mode_settings: [ 'heat', 'cool', 'heat_cool', 'off' ], current_climate_setting: { display_name: 'eco', hvac_mode_setting: 'heat_cool', manual_override_allowed: true, cooling_set_point_celsius: 25, cooling_set_point_fahrenheit: 77, heating_set_point_celsius: 20, heating_set_point_fahrenheit: 68 }, ... }, can_hvac_cool: true, can_hvac_heat: true, can_turn_off_hvac: true, can_hvac_heat_cool: true, ... }, ... ] ``` {% endtab %} {% tab title="cURL" %} **Request:** ```bash # Use GET or POST. curl -X 'GET' \ 'https://connect.getseam.com/thermostats/list' \ -H 'accept: application/json' \ -H "Authorization: Bearer ${API_KEY}" \ -H 'Content-Type: application/json' \ -d '{ "manufacturer": "nest" }' ``` **Response:** ```json { "thermostats": [ { "device_id": "a4b775e3-feb2-4c6b-8e78-a73ec2d70b61", "device_type": "nest_thermostat", "properties": { "online": true, "is_cooling": false, "is_heating": false, "is_fan_running": false, "manufacturer": "nest", "relative_humidity": 0.46, "temperature_celsius": 24.64, "temperature_fahrenheit": 76.352, "current_climate_setting": { "display_name": "eco", "hvac_mode_setting": "heat_cool", "manual_override_allowed": true, "cooling_set_point_celsius": 25, "cooling_set_point_fahrenheit": 77, "heating_set_point_celsius": 20, "heating_set_point_fahrenheit": 68 }, "available_hvac_mode_settings": [ "heat", "cool", "heat_cool", "off" ], ... }, "can_hvac_cool": true, "can_hvac_heat": true, "can_turn_off_hvac": true, "can_hvac_heat_cool": true, ... }, ... ], "ok": true } ``` {% endtab %} {% tab title="Python" %} **Request:** ```python seam.thermostats.list( manufacturer = "nest" ) ``` **Response:** ``` [ Device( can_hvac_cool=True, can_hvac_heat=True, can_hvac_heat_cool=True, can_turn_off_hvac=True, device_id='a4b775e3-feb2-4c6b-8e78-a73ec2d70b61', device_type='nest_thermostat', properties={ 'available_hvac_mode_settings': [ 'heat', 'cool', 'heat_cool', 'off' ], 'current_climate_setting': { 'display_name': 'eco', 'cooling_set_point_celsius': 25, 'cooling_set_point_fahrenheit': 77, 'heating_set_point_celsius': 20, 'heating_set_point_fahrenheit': 68, 'hvac_mode_setting': 'heat_cool', 'manual_override_allowed': True }, 'is_cooling': False, 'is_fan_running': False, 'is_heating': False, 'manufacturer': 'nest', 'online': True, 'relative_humidity': 0.46, 'temperature_celsius': 24.64, 'temperature_fahrenheit': 76.352, ... }, ... ), ... ] ``` {% endtab %} {% tab title="Ruby" %} **Request:** ```ruby seam.thermostats.list( manufacturer: "nest" ) ``` **Response:** ``` [ true, "is_cooling"=>false, "is_heating"=>false, "manufacturer"=>"nest", "is_fan_running"=>false, "relative_humidity"=>0.36, "temperature_celsius"=>21.11111111111111, "temperature_fahrenheit"=>70, "available_hvac_mode_settings"=>[ "heat", "cool", "heat_cool", "off" ], "current_climate_setting"=>{ "climate_preset_key"=>"unoccupied", "can_edit"=>true, "can_delete"=>true, "display_name"=>"unoccupied", "fan_mode_setting"=>"auto", "hvac_mode_setting"=>"heat_cool", "manual_override_allowed"=>true, "cooling_set_point_celsius"=>30, "heating_set_point_celsius"=>15, "cooling_set_point_fahrenheit"=>86, "heating_set_point_fahrenheit"=>59 }, ... }> can_hvac_cool=true can_hvac_heat=true can_turn_off_hvac=true can_hvac_heat_cool=true ... >, ... ] ``` {% endtab %} {% tab title="PHP" %} **Request:** ```php $seam->thermostats->list( manufacturer: "nest" ); ``` **Response:** ```json [ { "can_hvac_cool": true, "can_hvac_heat": true, "can_hvac_heat_cool": true, "can_turn_off_hvac": true, "device_id": "a4b775e3-feb2-4c6b-8e78-a73ec2d70b61", "device_type": "nest_thermostat", "properties": { "manufacturer": "nest", "online": true, "available_hvac_mode_settings": [ "heat", "cool", "heat_cool", "off" ], "current_climate_setting": { "display_name": "eco", "cooling_set_point_celsius": 25, "cooling_set_point_fahrenheit": 77, "heating_set_point_celsius": 20, "heating_set_point_fahrenheit": 68, "hvac_mode_setting": "heat_cool", "manual_override_allowed": true }, "is_cooling": false, "is_fan_running": false, "is_heating": false, "relative_humidity": 0.46, "temperature_celsius": 24.64, "temperature_fahrenheit": 76.352, ... }, ... }, ... ] ``` {% endtab %} {% tab title="C#" %} **Request:** ```csharp // Coming soon! ``` **Response:** ```json // Coming soon! ``` {% endtab %} {% endtabs %} *** ## Get an Individual Thermostat To get a specific [thermostat](/latest/capability-guides/thermostats.md), issue a [`/devices/get`](https://docs.seam.co/latest/api/devices/get) request, including the desired `device_id`. {% tabs %} {% tab title="JavaScript" %} **Request:** ```javascript await seam.devices.get({ device_id: "a4b775e3-feb2-4c6b-8e78-a73ec2d70b61" }); ``` **Response:** ```json { device_id: 'a4b775e3-feb2-4c6b-8e78-a73ec2d70b61', device_type: 'nest_thermostat', properties: { online: true, is_cooling: false, is_heating: false, manufacturer: 'nest', is_fan_running: false, relative_humidity: 0.46, temperature_celsius: 24.64, temperature_fahrenheit: 76.352, current_climate_setting: [Object], available_hvac_mode_settings: [ 'heat', 'cool', 'heat_cool', 'off' ], current_climate_setting: { display_name: 'eco', hvac_mode_setting: 'heat_cool', manual_override_allowed: true, cooling_set_point_celsius: 25, cooling_set_point_fahrenheit: 77, heating_set_point_celsius: 20, heating_set_point_fahrenheit: 68 }, ... }, can_hvac_cool: true, can_hvac_heat: true, can_turn_off_hvac: true, can_hvac_heat_cool: true, ... } ``` {% endtab %} {% tab title="cURL" %} **Request:** ```bash # Use GET or POST. curl -X 'GET' \ 'https://connect.getseam.com/devices/get' \ -H 'accept: application/json' \ -H 'Authorization: Bearer ${API_KEY}' \ -H 'Content-Type: application/json' \ -d '{ "device_id": "a4b775e3-feb2-4c6b-8e78-a73ec2d70b61" }' ``` **Response:** ```json { "device": { "device_id": "a4b775e3-feb2-4c6b-8e78-a73ec2d70b61", "device_type": "nest_thermostat", "properties": { "online": true, "is_cooling": false, "is_heating": false, "is_fan_running": false, "manufacturer": "nest", "relative_humidity": 0.46, "temperature_celsius": 24.64, "temperature_fahrenheit": 76.352, "current_climate_setting": { "display_name": "eco", "hvac_mode_setting": "heat_cool", "manual_override_allowed": true, "cooling_set_point_celsius": 25, "cooling_set_point_fahrenheit": 77, "heating_set_point_celsius": 20, "heating_set_point_fahrenheit": 68 }, "available_hvac_mode_settings": [ "heat", "cool", "heat_cool", "off" ], ... }, "can_hvac_cool": true, "can_hvac_heat": true, "can_turn_off_hvac": true, "can_hvac_heat_cool": true, ... }, "ok": true } ``` {% endtab %} {% tab title="Python" %} **Request:** ```python seam.devices.get( device_id = "a4b775e3-feb2-4c6b-8e78-a73ec2d70b61" ) ``` **Response:** ``` Device( can_hvac_cool=True, can_hvac_heat=True, can_hvac_heat_cool=True, can_turn_off_hvac=True, device_id='a4b775e3-feb2-4c6b-8e78-a73ec2d70b61', device_type='nest_thermostat', properties={ 'available_hvac_mode_settings': [ 'heat', 'cool', 'heat_cool', 'off' ], 'current_climate_setting': { 'display_name': 'eco', 'cooling_set_point_celsius': 25, 'cooling_set_point_fahrenheit': 77, 'heating_set_point_celsius': 20, 'heating_set_point_fahrenheit': 68, 'hvac_mode_setting': 'heat_cool', 'manual_override_allowed': True }, 'is_cooling': False, 'is_fan_running': False, 'is_heating': False, 'manufacturer': 'nest', 'online': True, 'relative_humidity': 0.46, 'temperature_celsius': 24.64, 'temperature_fahrenheit': 76.352, ... }, ... ) ``` {% endtab %} {% tab title="Ruby" %} **Request:** ```ruby # Coming soon! ``` **Response:** ``` # Coming soon! ``` {% endtab %} {% tab title="PHP" %} **Request:** ```php $seam->devices->get( device_id: "a4b775e3-feb2-4c6b-8e78-a73ec2d70b61" ); ``` **Response:** ```json { "can_hvac_cool": true, "can_hvac_heat": true, "can_hvac_heat_cool": true, "can_turn_off_hvac": true, "device_id": "a4b775e3-feb2-4c6b-8e78-a73ec2d70b61", "device_type": "nest_thermostat", "properties": { "manufacturer": "nest", "online": true, "available_hvac_mode_settings": [ "heat", "cool", "heat_cool", "off" ], "current_climate_setting": { "display_name": "eco", "cooling_set_point_celsius": 25, "cooling_set_point_fahrenheit": 77, "heating_set_point_celsius": 20, "heating_set_point_fahrenheit": 68, "hvac_mode_setting": "heat_cool", "manual_override_allowed": true }, "is_cooling": false, "is_fan_running": false, "is_heating": false, "relative_humidity": 0.46, "temperature_celsius": 24.64, "temperature_fahrenheit": 76.352, ... }, ... } ``` {% endtab %} {% tab title="C#" %} **Request:** ```csharp // Coming soon! ``` **Response:** ``` // Coming soon! ``` {% endtab %} {% endtabs %} --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.seam.co/latest/capability-guides/thermostats/retrieving-thermostats.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.