<br />

# ThermostatHvac Schema

[Nest Thermostat](https://developers.google.com/nest/device-access/api/thermostat)

`sdm.devices.traits.ThermostatHvac`

This trait belongs to device types of THERMOSTAT that can report HVAC details.

<br />

## Fields


| Field | Description | Data Type |
|---|---|---|
| `status` | Current HVAC status of the thermostat. | `string` Values: "OFF", "HEATING", "COOLING" |

<br />

### Timing of events

Note that an event for a change in HVAC status may not be delivered at the same time as events
for a thermostat mode change.

For example, sometimes there is
[a
delay in starting a thermostat's heating or cooling mode](https://support.google.com/googlenest/answer/9233450) in order to protect the HVAC
system. In this scenario, changing the thermostat mode may only initially send events for
[ThermostatMode](https://developers.google.com/nest/device-access/traits/device/thermostat-mode) and
[ThermostatTemperatureSetpoint](https://developers.google.com/nest/device-access/traits/device/thermostat-temperature-setpoint) trait changes, with the
ThermostatHvac trait change sent later as a separate
event once the system actually turns on. If there was no delay in turning on the HVAC system, all
three events would be sent at the same time.

<br />

#### Sample GET request and response

### Request

```
GET /enterprises/project-id/devices/device-id
```

### Response

    {
      "name" : "enterprises/project-id/devices/device-id",
      "traits" : {
        "sdm.devices.traits.ThermostatHvac" : {
          "status" : "HEATING"
        }
      }
    }

<br />

## Commands

There are no commands available for this trait.


## Errors

See the [API Error Code Reference](https://developers.google.com/nest/device-access/reference/errors/api) for
the full list of API error codes.

<br />