Skip to main content
GET
/
hvac
/
{deviceId}
curl
curl --request GET \
  --url 'https://api.amps.ai/hvac/dev_abc123' \
  --header 'x-api-key: amps_sk_test_xxxxxxxxxxxxxxxxxxxxxxxx'
{
  "id": "device_hvac_001",
  "vendor": "example_vendor_a",
  "sync": {
    "available": true,
    "lastPulledAt": "2026-05-07T09:23:45.000Z"
  },
  "metadata": {
    "model": "Smart Thermostat 4",
    "source": "live"
  },
  "state": {
    "temperature": 18.5,
    "active": true,
    "heatSetpoint": 21,
    "coolSetpoint": 25,
    "holdType": "follow_schedule",
    "mode": "heat"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.amps.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
deviceId
string
required

The unique identifier for the HVAC device

Example:

"device_abc123"

Query Parameters

​
expedite
boolean

Use expedite cache with 1 minute TTL instead of normal 15 minute TTL

Example:

false

Response

HVAC state retrieved successfully

​
id
string
required

Unique identifier for the HVAC device.

​
vendor
string
required

OEM display name.

​
sync
object
required
​
metadata
object
required
​
state
object
required