---
title: "List schedules"
method: GET
path: "/v2/schedules"
tags: ["Schedules"]
---

# List schedules

`GET /v2/schedules`

## Request

- Base URL: `https://qstash-eu-central-1.upstash.io`
- URL: `https://qstash-eu-central-1.upstash.io/v2/schedules`
- Auth: one of:
  - HTTP bearer
  - API key in query parameter `qstash_token`
- TypeScript: <https://skmtc.dev/upstash/apis/qstash-rest-api/docs/v2/schedules/get.ts> (a function with typed inputs; its response is checked against the schema)

List all schedules

## Response `200`

List of schedules

- Schedule[]
  - `scheduleId` string, required: Unique identifier for the schedule
  - `cron` string, required: The cron expression used to schedule the message
  - `destination` string, required: The destination URL or URL Group name
  - `createdAt` integer, required: The creation timestamp of the schedule in unix milliseconds
  - `method` string, required: The HTTP method used for the scheduled message
  - `header` object: Map of header names to arrays of header values
  - `body` string: The body of the scheduled message
  - `retries` integer: The number of retries for the scheduled message
  - `delay` integer: The delay in seconds before the scheduled message is sent
  - `callback` string: The callback URL for the scheduled message
  - `failureCallback` string: The failure callback URL for the scheduled message
  - `callerIp` string: The IP address of the client that created the schedule
  - `isPaused` boolean, required: Whether the schedule is paused
  - `flowControlKey` string: The flow control key used for rate limiting
  - `parallelism` integer: The parallelism value used for flow control
  - `rate` integer: The rate value used for flow control
  - `period` integer: The period value used for flow control
  - `retryDelayExpression` string: The retry delay expression used for calculating retry delays
  - `label` string: The label assigned to the scheduled message. Deprecated in favor of `labels`.
  - `labels` string[]: The list of labels assigned to the scheduled message.
  - `lastScheduleTime` integer: The last time the schedule was triggered in unix milliseconds
  - `nextScheduleTime` integer: The next scheduled trigger time in unix milliseconds
  - `lastScheduleStates` object: The states of the last scheduled messages

## Changes

- **2026-06-09** `d30bd0904328`: 2 info
  - added the optional property `items/labels` to the response with the `200` status
  - response property `items/label` deprecated
- **2026-06-09** `d859c277ced2`: 1 warning, 1 info
  - removed the optional property `items/labels` from the response with the `200` status
  - response property `items/label` reactivated
- **2026-05-15** `75ecd1c6fb73`: 2 info
  - added the optional property `items/labels` to the response with the `200` status
  - response property `items/label` deprecated

[Operation history](https://skmtc.dev/upstash/apis/qstash-rest-api/changes/v2/schedules/get.md)

---

[API](https://skmtc.dev/upstash/apis/qstash-rest-api.md) - [All operations](https://skmtc.dev/upstash/apis/qstash-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/upstash/apis/qstash-rest-api/revisions/0c3b83ef4770?raw)