List Thermostat Schedules

POST /thermostats/schedules/list ⇒ { thermostat_schedules: [thermostat_schedule, …] }

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

JavaScript

Request

await seam.thermostats.schedules.list({
  device_id: "123e4567-e89b-12d3-a456-426614174000",
});

Response

[
  {
    "thermostat_schedule_id": "89d3507e-60e3-4101-bd1b-ba066ec30ad4",
    "name": "Reservation 2",
    "device_id": "2d488679-6f07-4810-aed2-e726872c1dd5",
    "climate_preset_key": "occupied",
    "starts_at": "2024-11-10T15:00:00.000Z",
    "ends_at": "2024-11-15T12:00:00.000Z",
    "max_override_period_minutes": 90
  },
  {
    "thermostat_schedule_id": "665553d1-94f9-4e92-9739-06ac6362c959",
    "name": "Reservation 3",
    "device_id": "2d488679-6f07-4810-aed2-e726872c1dd5",
    "climate_preset_key": "occupied",
    "starts_at": "2024-11-16T15:00:00.000Z",
    "ends_at": "2024-11-18T12:00:00.000Z",
    "max_override_period_minutes": 90
  }
]

Python

Request

seam.thermostats.schedules.list(device_id="123e4567-e89b-12d3-a456-426614174000")

Response

[
    ThermostatSchedule(
        thermostat_schedule_id="89d3507e-60e3-4101-bd1b-ba066ec30ad4",
        name="Reservation 2",
        device_id="2d488679-6f07-4810-aed2-e726872c1dd5",
        climate_preset_key="occupied",
        starts_at="2024-11-10T15:00:00.000Z",
        ends_at="2024-11-15T12:00:00.000Z",
        max_override_period_minutes=90,
    ),
    ThermostatSchedule(
        thermostat_schedule_id="665553d1-94f9-4e92-9739-06ac6362c959",
        name="Reservation 3",
        device_id="2d488679-6f07-4810-aed2-e726872c1dd5",
        climate_preset_key="occupied",
        starts_at="2024-11-16T15:00:00.000Z",
        ends_at="2024-11-18T12:00:00.000Z",
        max_override_period_minutes=90,
    ),
]

Ruby

Request

seam.thermostats.schedules.list(device_id: "123e4567-e89b-12d3-a456-426614174000")

Response

[
  {
    "thermostat_schedule_id" => "89d3507e-60e3-4101-bd1b-ba066ec30ad4",
    "name" => "Reservation 2",
    "device_id" => "2d488679-6f07-4810-aed2-e726872c1dd5",
    "climate_preset_key" => "occupied",
    "starts_at" => "2024-11-10T15:00:00.000Z",
    "ends_at" => "2024-11-15T12:00:00.000Z",
    "max_override_period_minutes" => 90,
  },
  {
    "thermostat_schedule_id" => "665553d1-94f9-4e92-9739-06ac6362c959",
    "name" => "Reservation 3",
    "device_id" => "2d488679-6f07-4810-aed2-e726872c1dd5",
    "climate_preset_key" => "occupied",
    "starts_at" => "2024-11-16T15:00:00.000Z",
    "ends_at" => "2024-11-18T12:00:00.000Z",
    "max_override_period_minutes" => 90,
  },
]

PHP

Request

<?php
$seam->thermostats->schedules->list(
    device_id: "123e4567-e89b-12d3-a456-426614174000"
);

Response

<?php
[
    [
        "thermostat_schedule_id" => "89d3507e-60e3-4101-bd1b-ba066ec30ad4",
        "name" => "Reservation 2",
        "device_id" => "2d488679-6f07-4810-aed2-e726872c1dd5",
        "climate_preset_key" => "occupied",
        "starts_at" => "2024-11-10T15:00:00.000Z",
        "ends_at" => "2024-11-15T12:00:00.000Z",
        "max_override_period_minutes" => 90,
    ],
    [
        "thermostat_schedule_id" => "665553d1-94f9-4e92-9739-06ac6362c959",
        "name" => "Reservation 3",
        "device_id" => "2d488679-6f07-4810-aed2-e726872c1dd5",
        "climate_preset_key" => "occupied",
        "starts_at" => "2024-11-16T15:00:00.000Z",
        "ends_at" => "2024-11-18T12:00:00.000Z",
        "max_override_period_minutes" => 90,
    ],
];

Seam CLI

Request

seam thermostats schedules list --device_id "123e4567-e89b-12d3-a456-426614174000"

Response

[
  {
    "thermostat_schedule_id": "89d3507e-60e3-4101-bd1b-ba066ec30ad4",
    "name": "Reservation 2",
    "device_id": "2d488679-6f07-4810-aed2-e726872c1dd5",
    "climate_preset_key": "occupied",
    "starts_at": "2024-11-10T15:00:00.000Z",
    "ends_at": "2024-11-15T12:00:00.000Z",
    "max_override_period_minutes": 90
  },
  {
    "thermostat_schedule_id": "665553d1-94f9-4e92-9739-06ac6362c959",
    "name": "Reservation 3",
    "device_id": "2d488679-6f07-4810-aed2-e726872c1dd5",
    "climate_preset_key": "occupied",
    "starts_at": "2024-11-16T15:00:00.000Z",
    "ends_at": "2024-11-18T12:00:00.000Z",
    "max_override_period_minutes": 90
  }
]

Go

Request

package main

import api "github.com/seamapi/go"
import schedules "github.com/seamapi/go/schedules"

func main() {
	client.Thermostats.Schedules.List(
		context.Background(),
		schedules.SchedulesListRequest{
			DeviceId: api.String("123e4567-e89b-12d3-a456-426614174000"),
		},
	)
}

Response

[]api.ThermostatSchedule{api.ThermostatSchedule{ThermostatScheduleId: "89d3507e-60e3-4101-bd1b-ba066ec30ad4", Name: "Reservation 2", DeviceId: "2d488679-6f07-4810-aed2-e726872c1dd5", ClimatePresetKey: "occupied", StartsAt: "2024-11-10T15:00:00.000Z", EndsAt: "2024-11-15T12:00:00.000Z", MaxOverridePeriodMinutes: 90}, api.ThermostatSchedule{ThermostatScheduleId: "665553d1-94f9-4e92-9739-06ac6362c959", Name: "Reservation 3", DeviceId: "2d488679-6f07-4810-aed2-e726872c1dd5", ClimatePresetKey: "occupied", StartsAt: "2024-11-16T15:00:00.000Z", EndsAt: "2024-11-18T12:00:00.000Z", MaxOverridePeriodMinutes: 90}}

Authentication Methods

• API key

• Client session token

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

Request Parameters

device_id

Type: string Required: Yes

ID of the desired thermostat device.

---

user_identifier_key

Type: string Required: No

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

---

Return Type

Array<thermostat_schedule>