---
title: "Show Weekly Schedule"
method: GET
path: "/thermostats/{thermostatId}/schedule"
tags: ["thermostats"]
---

# Show Weekly Schedule

`GET /thermostats/{thermostatId}/schedule`

## Request

- Base URL: `https://api.sb.ecobee.com/api/v2`
- URL: `https://api.sb.ecobee.com/api/v2/thermostats/{thermostatId}/schedule`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://api.sb.ecobee.com/api/v2/token` scopes: `read:thermostat`

Returns a schedule object that contains keys for each day of the week. Each daily schedule is represented by an array containing 48 comfort setting periods. The first period of the day is the first entry of the array (00:00), and the last period is the last entry (23:30).

## Response `200`

Success

- ThermostatSchedule
  - `status` 'success'
  - `data` object
    - `monday` string[]: List of comfort setting refs that represent the Monday schedule in 48 thirty minute time blocks
    - `tuesday` string[]: List of comfort setting refs that represent the Tuesday schedule in 48 thirty minute time blocks
    - `wednesday` string[]: List of comfort setting refs that represent the Wednesday schedule in 48 thirty minute time blocks
    - `thursday` string[]: List of comfort setting refs that represent the Thursday schedule in 48 thirty minute time blocks
    - `friday` string[]: List of comfort setting refs that represent the Friday schedule in 48 thirty minute time blocks
    - `saturday` string[]: List of comfort setting refs that represent the Saturday schedule in 48 thirty minute time blocks
    - `sunday` string[]: List of comfort setting refs that represent the Sunday schedule in 48 thirty minute time blocks

## Other responses

- `401`: Not authenticated
- `403`: Not authorized
- `404`: Not found
- `422`: Validation Failed
- `429`: Too many requests
- `500`: Internal server error
- `default`: Unexpected error

---

[API](https://skmtc.dev/ecobee/apis/ecobee-smartbuildings-public-api.md) - [All operations](https://skmtc.dev/ecobee/apis/ecobee-smartbuildings-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ecobee/apis/ecobee-smartbuildings-public-api/revisions/d78d4fd5e1c6?raw)