List Thermostat Schedules

• Request Parameters

• Response

• Examples

Returns a list of all thermostat schedules for a specified thermostat.

JavaScript

Returns a list of all thermostat schedules for a specified thermostat, using a device ID.

Code:

await seam.thermostats.schedules.list({
  device_id: "b5d58842-32be-46d2-b161-26787a0bd5ea",
});

Output:

[
  {
    "climate_preset_key": "Eco",
    "created_at": "2025-06-14T16:54:17.946316Z",
    "device_id": "b5d58842-32be-46d2-b161-26787a0bd5ea",
    "ends_at": "2025-07-14T16:54:17.946313Z",
    "errors": [],
    "is_override_allowed": true,
    "max_override_period_minutes": 90,
    "name": "Unoccupied",
    "starts_at": "2025-07-12T16:54:17.946313Z",
    "thermostat_schedule_id": "af2cb7f7-9f28-40da-a0a0-e7a008ef7a35",
    "workspace_id": "58419b36-6103-44e5-aa83-2163e90cce01"
  }
]

cURL

Python

Ruby

PHP

Seam CLI

Authentication Methods

• API key

• Client session token

• Personal access token Must also include the seam-workspace header in the request.

To learn more, see Authentication.

Request Parameters

device_id String (Required)

ID of the thermostat device for which you want to list schedules.

---

user_identifier_key String

User identifier key by which to filter the list of returned thermostat schedules.

---

Response

Returns: Array of thermostat_schedules

JSON

{
  "climate_preset_key": "eco",
  "created_at": "2025-06-14T16:54:17.946316Z",
  "device_id": "dc1dfc4b-8082-453f-a953-276941af8650",
  "ends_at": "2025-07-14T16:54:17.946313Z",
  "errors": [],
  "is_override_allowed": true,
  "max_override_period_minutes": 90,
  "name": "My Thermostat Schedule",
  "starts_at": "2025-07-12T16:54:17.946313Z",
  "thermostat_schedule_id": "af2cb7f7-9f28-40da-a0a0-e7a008ef7a35",
  "workspace_id": "58419b36-6103-44e5-aa83-2163e90cce01"
}

---

Examples

List thermostat schedules by user identifier key

Returns a list of all thermostat schedules for a specified thermostat, using a user identifier key.

JavaScript

Code:

await seam.thermostats.schedules.list({
  user_identifier_key: "b5c8bf4e-c231-474f-b4dc-adad38c25d3f",
});

Output:

[
  {
    "climate_preset_key": "Eco",
    "created_at": "2025-06-14T16:54:17.946316Z",
    "device_id": "dc1dfc4b-8082-453f-a953-276941af8650",
    "ends_at": "2025-07-14T16:54:17.946313Z",
    "errors": [],
    "is_override_allowed": true,
    "max_override_period_minutes": 90,
    "name": "Unoccupied",
    "starts_at": "2025-07-12T16:54:17.946313Z",
    "thermostat_schedule_id": "af2cb7f7-9f28-40da-a0a0-e7a008ef7a35",
    "workspace_id": "58419b36-6103-44e5-aa83-2163e90cce01"
  }
]

cURL

Python

Ruby

PHP

Seam CLI