> ## Documentation Index
> Fetch the complete documentation index at: https://docs.seam.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Retrieving Thermostats

> Learn how to retrieve all thermostats or a specific thermostat by ID.

When you use the [`/thermostats/list`](/api/thermostats/list) and [`/devices/get`](/api/devices/get) endpoints to retrieve information about your connected thermostats, the Seam API returns the following categories of information:

<table>
  <thead>
    <tr>
      <th width="250">Category</th>
      <th>Details</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>Current conditions </td>

      <td>
        Current temperature in Fahrenheit and Celsius, current relative
        humidity, and so on. This includes such properties as{' '}
        <code>temperature\_celsius</code>, <code>temperature\_fahrenheit</code>,{' '}
        <code>is\_cooling</code>, <code>is\_heating</code>,{' '}
        <code>is\_fan\_running</code>, <code>relative\_humidity</code>{' '}
      </td>
    </tr>

    <tr>
      <td>Current operational status</td>

      <td>
        Whether the associated HVAC system is currently heating or cooling,
        whether the fan is currently running. These properties are named{' '}
        <code>current\_climate\_setting</code> and reflect what the thermostat is
        set to 'achieve'.
      </td>
    </tr>

    <tr>
      <td>Available HVAC modes for the thermostat</td>

      <td>
        <code>heat</code>, <code>cool</code>, <code>heat\_cool</code>, and{' '}
        <code>off</code>.
      </td>
    </tr>

    <tr>
      <td>Available fan modes for the thermostat</td>

      <td>
        <code>on</code>, <code>auto</code>, and <code>circulate</code>.
      </td>
    </tr>

    <tr>
      <td>
        Thermostat <a href="/capability-guides/thermostats#thermostat-capabilities">capability flags</a>
      </td>

      <td>
        <p>Capabilities of the thermostat—at a granular level.</p>
        <p>These capability flags include the following:</p>

        <ul>
          <li>
            <code>device.can\_hvac\_heat</code>
          </li>

          <li>
            <code>device.can\_hvac\_cool</code>
          </li>

          <li>
            <code>device.can\_hvac\_heat\_cool</code>
          </li>

          <li>
            <code>device.can\_turn\_off\_hvac</code>
          </li>
        </ul>
      </td>
    </tr>

    <tr>
      <td>Available climate presets</td>
      <td>Climate presets that you can schedule on the thermostat.</td>
    </tr>

    <tr>
      <td>Climate preset constraints</td>

      <td>
        Constraints related to climate presets for the specific thermostat brand
        or model.

        <br />

        For example, a thermostat might have a minimum or maximum cooling or
        heating{' '}

        <a href="/capability-guides/thermostats/understanding-thermostat-concepts/set-points">
          set point
        </a>

        {' '}

        or a{' '}

        <a href="../../capability-guides/thermostats/understanding-thermostat-concepts/set-points#minimum-heating-cooling-temperature-delta">
          minimum delta
        </a>

        {' '}

        between the cooling and heating set points.
      </td>
    </tr>
  </tbody>
</table>

## List All Thermostats

To retrieve all [thermostats](./), issue a [`/thermostats/list`](/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:

**Request:**

<CodeGroup>
  ```javascript JavaScript theme={null}
  await seam.thermostats.list({
    manufacturer: 'nest',
  })
  ```

  ```bash cURL theme={null}
  # 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"
    }'
  ```

  ```python Python theme={null}
  seam.thermostats.list(
    manufacturer = "nest"
  )
  ```

  ```ruby Ruby theme={null}
  seam.thermostats.list(
    manufacturer: "nest"
  )
  ```

  ```php PHP theme={null}
  $seam->thermostats->list(
    manufacturer: "nest"
  );
  ```

  ```csharp C# theme={null}
  // Coming soon!
  ```
</CodeGroup>

**Response:**

<CodeGroup>
  ```json JavaScript theme={null}
  [
    {
      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,
      ...
    },
    ...
  ]
  ```

  ```json cURL theme={null}
  {
    "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
  }
  ```

  ```json Python theme={null}
  [
    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,
        ...
      },
      ...
    ),
    ...
  ]
  ```

  ```json Ruby theme={null}
  [
    <Seam::Resources::Device:0x005f0
      device_id="a4b775e3-feb2-4c6b-8e78-a73ec2d70b61"
      device_type="nest_thermostat"
      properties=#<Seam::DeepHashAccessor:0x0000016b1791f068 @data={
        "online"=>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
      ...
    >,
    ...
  ]
  ```

  ```json PHP theme={null}
  [
    {
      "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,
        ...
      },
      ...
    },
    ...
  ]
  ```

  ```json C# theme={null}
  // Coming soon!
  ```
</CodeGroup>

***

## Get an Individual Thermostat

To get a specific [thermostat](./), issue a [`/devices/get`](/api/devices/get) request, including the desired `device_id`.

**Request:**

<CodeGroup>
  ```javascript JavaScript theme={null}
  await seam.devices.get({
    device_id: 'a4b775e3-feb2-4c6b-8e78-a73ec2d70b61',
  })
  ```

  ```bash cURL theme={null}
  # 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"
  }'
  ```

  ```python Python theme={null}
  seam.devices.get(
    device_id = "a4b775e3-feb2-4c6b-8e78-a73ec2d70b61"
  )
  ```

  ```ruby Ruby theme={null}
  # Coming soon!
  ```

  ```php PHP theme={null}
  $seam->devices->get(
    device_id: "a4b775e3-feb2-4c6b-8e78-a73ec2d70b61"
  );
  ```

  ```csharp C# theme={null}
  // Coming soon!
  ```
</CodeGroup>

**Response:**

<CodeGroup>
  ```json JavaScript theme={null}
  {
    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,
    ...
  }
  ```

  ```json cURL theme={null}
  {
    "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
  }
  ```

  ```json Python theme={null}
  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,
      ...
    },
    ...
  )
  ```

  ```json Ruby theme={null}
  # Coming soon!
  ```

  ```json PHP theme={null}
  {
    "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,
      ...
    },
    ...
  }
  ```

  ```json C# theme={null}
  // Coming soon!
  ```
</CodeGroup>