List Thermostat Schedules

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

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": "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"
  }
]

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

Code

curl --include --request POST "https://connect.getseam.com/thermostats/schedules/list" \
  --header "Authorization: Bearer $SEAM_API_KEY" \
  --json @- <<EOF
{
  "device_id": "b5d58842-32be-46d2-b161-26787a0bd5ea"
}
EOF

Output

{
  "thermostat_schedules": [
    {
      "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"
    }
  ]
}

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

Code

seam.thermostats.schedules.list(device_id="b5d58842-32be-46d2-b161-26787a0bd5ea")

Output

[
    ThermostatSchedule(
        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",
    )
]

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

Code

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" => "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",
  },
]

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

Code

<?php
$seam->thermostats->schedules->list(
    device_id: "b5d58842-32be-46d2-b161-26787a0bd5ea"
);

Output

<?php
[
    [
        "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",
    ],
];

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

Code

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": "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"
  }
]

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

Array of thermostat_schedules

{
  "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