---
title: "List all schedules"
method: GET
path: "/schedules"
tags: ["Schedule"]
---

# List all schedules

`GET /schedules`

Multiple status values can be provided with comma separated strings

## Response `200`

successful operation

- PaginatedSchedule[]
  - `data` Schedule[]
    - `id` string — Schedule ID.
    - `label` string — Label of the schedule
    - `admin_email` string — Admin emailaddress
    - `testmode` boolean — When in test mode only the admin gets an email
    - `is_active` boolean — Only when the task is active it will execute on the specified time
    - `created_at` string, date-time — Created at timestamp
    - `updated_at` string, date-time — Updated at timestamp
    - `site_id` string — The ID of the site the schedule is connected to.
    - `start_on` string, date — The date the schedule has to start
    - `end_on` string, date — The date the schedule has to end
    - `notify_on_failure` boolean — Notify all recipient in case of failure. This way the recipients know we are aware of the issue and we look for a solution. Hence they won't feel the need to message you to notify you it is not working.
    - `tasks_count` integer — Number of tasks attached to this schedule
    - `active_tasks_count` integer — Number of active tasks attached to this schedule
    - `upcoming` string, date-time — A timestamp that indicates the next moment the schedule will run. Note that this will not always display the correct value when using advanced triggers.
    - `frequencyString` string — A string that describes the next moment the schedule will run. Note that this will not always display the correct value when using advanced triggers.
    - `frequencies` string — An object to specify and determine the trigger moment for the schedule. This is an advanced object and should not be tempered with.
  - `current_page` integer
  - `last_page` integer

---

[API](https://skmtc.net/gitbookio/apis/mailscheduler.md) · [All operations](https://skmtc.net/gitbookio/apis/mailscheduler/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gitbookio/mailscheduler/revisions/c6c3717d477d/schema)