---
title: "Get an Installed App's Schedule"
method: GET
path: "/installedapps/{installedAppId}/schedules/{scheduleName}"
tags: ["Schedules"]
---

# Get an Installed App's Schedule

`GET /installedapps/{installedAppId}/schedules/{scheduleName}`

## Request

- Base URL: `https://api.smartthings.com/v1`
- URL: `https://api.smartthings.com/v1/installedapps/{installedAppId}/schedules/{scheduleName}`
- Auth: OAuth 2
  - Implicit: `https://auth-global.api.smartthings.com`
  - Scopes: `r:schedules`
- TypeScript: <https://skmtc.dev/smartthings/apis/smartthings-api/docs/installedapps/:installedAppId/schedules/:scheduleName/get.ts> (a function with typed inputs; its response is checked against the schema)

Get a specific schedule for an installed app by it's name.

## Response `200`

The schedule

- Schedule
  - `name` string, ^[A-Za-z0-9._\-]{1,36}$, required: The unique per installed app name of the schedule.
  - `installedAppId` string, uuid: The ID of the installed app.
  - `locationId` string, uuid: The ID of the location the installed app is in.
  - `userUuid` string, uuid: The UUID of the user who created the schedule.
  - `scheduledExecutions` integer[]: List of scheduled execution times in millis from jan 1 1970 UTC
  - `cron` CronSchedule
    - `expression` string, required: The cron expression for the schedule for CRON schedules. The format matches that specified by the [Quartz scheduler](http://www.quartz-scheduler.org/documentation/quartz-2.3.0/tutorials/crontrigger.html) but should not include the seconds (1st) field. The exact second will be chosen at random but will remain consistent. The years part must be les than 2 years from now.
    - `timezone` string, required: The timezone id for CRON schedules.

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `403`: Forbidden
- `429`: Too many requests
- `default`: Unexpected error

---

[API](https://skmtc.dev/smartthings/apis/smartthings-api.md) - [All operations](https://skmtc.dev/smartthings/apis/smartthings-api/llms.txt) - [OpenAPI document](https://skmtc.dev/smartthings/apis/smartthings-api/revisions/2788a4236800?raw)