---
title: "Get Schedules"
method: GET
path: "/v1/workflows/schedules"
tags: ["workflows.schedules"]
---

# Get Schedules

`GET /v1/workflows/schedules`

Get Schedules

## Query parameters

- `workflow_name` string, nullable — Filter by workflow name
- `user_id` string, nullable — Filter by user ID. Pass 'current' to resolve to the authenticated user's ID.
- `status` 'active' | 'paused', nullable — Filter by schedule status: 'active' or 'paused'
- `page_size` integer, nullable — Number of items per page. Omitting this parameter fetches all results at once (deprecated — pass page_size to use pagination).
- `next_page_token` string, nullable — Token for the next page of results

## Response `200`

Successful Response

- WorkflowScheduleListResponse
  - `schedules` ScheduleDefinitionOutput[], required — A list of workflow schedules
    - `input` unknown, required
    - `calendars` ScheduleCalendar[] — Calendar-based specification of times.
      - `second` ScheduleRange[]
        - `start` integer, required
        - `end` integer
        - `step` integer
      - `minute` ScheduleRange[]
        - `start` integer, required
        - `end` integer
        - `step` integer
      - `hour` ScheduleRange[]
        - `start` integer, required
        - `end` integer
        - `step` integer
      - `day_of_month` ScheduleRange[]
        - `start` integer, required
        - `end` integer
        - `step` integer
      - `month` ScheduleRange[]
        - `start` integer, required
        - `end` integer
        - `step` integer
      - `year` ScheduleRange[]
        - `start` integer, required
        - `end` integer
        - `step` integer
      - `day_of_week` ScheduleRange[]
        - `start` integer, required
        - `end` integer
        - `step` integer
      - `comment` string, nullable
    - `intervals` ScheduleInterval[] — Interval-based specification of times.
      - `every` string, duration, required
      - `offset` string, duration, nullable
    - `cron_expressions` string[] — Cron-based specification of times.
    - `skip` ScheduleCalendar[] — Set of calendar times to skip.
      - `second` ScheduleRange[]
        - `start` integer, required
        - `end` integer
        - `step` integer
      - `minute` ScheduleRange[]
        - `start` integer, required
        - `end` integer
        - `step` integer
      - `hour` ScheduleRange[]
        - `start` integer, required
        - `end` integer
        - `step` integer
      - `day_of_month` ScheduleRange[]
        - `start` integer, required
        - `end` integer
        - `step` integer
      - `month` ScheduleRange[]
        - `start` integer, required
        - `end` integer
        - `step` integer
      - `year` ScheduleRange[]
        - `start` integer, required
        - `end` integer
        - `step` integer
      - `day_of_week` ScheduleRange[]
        - `start` integer, required
        - `end` integer
        - `step` integer
      - `comment` string, nullable
    - `start_at` string, date-time, nullable — Time after which the first action may be run.
    - `end_at` string, date-time, nullable — Time after which no more actions will be run.
    - `jitter` string, duration, nullable — Jitter to apply each action. An action's scheduled time will be incremented by a random value between 0 and this value if present (but not past the next schedule).
    - `time_zone_name` string, nullable — IANA time zone name, for example ``US/Central``.
    - `policy` SchedulePolicy
      - `catchup_window_seconds` integer — After a Temporal server is unavailable, amount of time in seconds in the past to execute missed actions.
      - `overlap` 1 | 2 | 3 | 4 | 5 | 6 — Controls what happens when a workflow would be started by a schedule but one is already running.
      - `pause_on_failure` boolean — Whether to pause the schedule after a workflow failure.
    - `schedule_id` string, required — Unique identifier for the schedule.
    - `remaining_executions` integer, nullable — Remaining workflow executions before this schedule stops triggering automatically. null means unlimited; 0 means the limit has been reached and the schedule is exhausted.
    - `workflow_name` string, required — Name of the workflow this schedule triggers.
    - `deployment_name` string, nullable — Name of the deployment this schedule targets.
    - `paused` boolean, required — Whether the schedule is currently paused.
    - `note` string, nullable — Human-readable note associated with the current pause or resume state.
    - `future_executions` ScheduleFutureExecution[] — Upcoming scheduled executions (10 next executions, earliest first).
      - `scheduled_at` string, date-time, required — Time the execution is scheduled to run.
    - `recent_executions` ScheduleRecentExecution[] — Most recent scheduled executions (10 most recent, newest last).
      - `scheduled_at` string, date-time, required — Time the execution was scheduled to run.
      - `started_at` string, date-time, required — Actual time the execution started.
      - `execution_id` string, required — ID of the workflow execution that was started.
  - `next_page_token` string, nullable — Token for the next page of results

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/mistral/apis/mistral-ai-api.md) · [All operations](https://skmtc.net/mistral/apis/mistral-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mistral/mistral-ai-api/revisions/933c4ebdcd72/schema)