---
title: "Get Schedule"
method: GET
path: "/v1/workflows/schedules/{schedule_id}"
tags: ["workflows.schedules"]
---

# Get Schedule

`GET /v1/workflows/schedules/{schedule_id}`

Get Schedule

## Path parameters

- `schedule_id` string, required

## Response `200`

Successful Response

- ScheduleDefinitionOutput — Output representation of a schedule with required schedule_id. Used when returning schedules from the API where schedule_id is always present.
  - `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.

## 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)