Skip to main content
GET
/
hvac
curl
curl --request GET \
  --url 'https://api.amps.ai/hvac' \
  --header 'x-api-key: amps_sk_test_xxxxxxxxxxxxxxxxxxxxxxxx'
{
  "items": [
    {
      "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": 21.5,
        "active": true,
        "heatSetpoint": 20,
        "coolSetpoint": 24,
        "holdType": "follow_schedule",
        "mode": "auto"
      }
    },
    {
      "id": "device_hvac_002",
      "vendor": "example_vendor_b",
      "sync": {
        "available": true,
        "lastPulledAt": "2026-05-07T09:24:10.000Z"
      },
      "metadata": {
        "model": "Smart Thermostat 3",
        "source": "cache"
      },
      "state": {
        "temperature": 23.8,
        "active": false,
        "heatSetpoint": 18,
        "coolSetpoint": 22,
        "holdType": "permanent",
        "mode": "cool"
      }
    }
  ],
  "pagination": {
    "limit": 10,
    "offset": 0,
    "total": 2,
    "hasMore": false
  }
}

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

Query Parameters

​
userId
string

Filter devices by userId

Example:

"user_abc123"

​
offset
number

Number of devices to skip (default: 0)

Example:

0

​
limit
number

Maximum number of devices to return (1-50, default: 10)

Example:

10

Response

HVAC devices retrieved successfully

​
items
object[]
required
​
pagination
object
required