---
title: "Show Thermostat Status"
method: GET
path: "/thermostats/{thermostatId}/status"
tags: ["thermostats"]
---

# Show Thermostat Status

`GET /thermostats/{thermostatId}/status`

## Request

- Base URL: `https://api.sb.ecobee.com/api/v2`
- URL: `https://api.sb.ecobee.com/api/v2/thermostats/{thermostatId}/status`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://api.sb.ecobee.com/api/v2/token` scopes: `read:thermostat`

Returns dynamic thermostat state data

## Response `200`

Success

- ThermostatStatus
  - `status` 'success'
  - `data` object
    - `comfortSetting` string
    - `desiredCoolRange` object: The minimum and maximum values for a cool setPoint
      - `min` number, float
      - `max` number, float
    - `desiredDehumidity` integer: The maximum humidity value to be maintained
    - `desiredHeatRange` object: The minimum and maximum values for a heat setPoint
      - `min` number, float
      - `max` number, float
    - `desiredHumidity` integer: The minimum humidity value to be maintained
    - `heatCoolMinDelta` integer: The minimum difference between setPoints
    - `humidity` integer
    - `hvacMode` 'heat' | 'cool' | 'auto' | 'off' | 'auxHeatOnly': The HVAC mode on a thermostat. Possible values: auto, auxHeatOnly, cool, heat, off.
    - `id` string: The unique identifier for a thermostat. The ID will match the serial number on the physical thermostat.
    - `isConnected` boolean
    - `isResidentMode` boolean: Indicates whether the thermostat is currently in tenant/resident mode
    - `runningEquipment` object: A record of running equipment indicated by a boolean flag
      - `fan` boolean
      - `compCool1` boolean
      - `compCool2` boolean
      - `heatPump` boolean
      - `heatPump2` boolean
      - `heatPump3` boolean
      - `auxHeat1` boolean
      - `auxHeat2` boolean
      - `auxHeat3` boolean
      - `compHotWater` boolean
      - `auxHotWater` boolean
      - `humidifier` boolean
      - `dehumidifier` boolean
      - `ventilator` boolean
      - `economizer` boolean
    - `setPoint` SetPoint
      - `desiredCool` number, float
      - `desiredHeat` number, float
    - `temperature` number, float

## Other responses

- `401`: Not authenticated
- `403`: Not authorized
- `404`: Not found
- `422`: Validation Failed
- `429`: Too many requests
- `500`: Internal server error
- `default`: Unexpected error

---

[API](https://skmtc.dev/ecobee/apis/ecobee-smartbuildings-public-api.md) - [All operations](https://skmtc.dev/ecobee/apis/ecobee-smartbuildings-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ecobee/apis/ecobee-smartbuildings-public-api/revisions/d78d4fd5e1c6?raw)