---
title: "List Schedules"
method: GET
path: "/worker/{worker_id}/schedules"
tags: ["worker-schedules"]
---

# List Schedules

`GET /worker/{worker_id}/schedules`

## Path parameters

- `worker_id` string, required

## Query parameters

- `page` integer — Page number for pagination
- `limit` integer — Number of schedules per page (max 1000)
- `status` 'active' | 'completed' — Visibility filter for paginated Worker schedule lists. Active rows have no ``completed_at``. Completed rows are one-shots that have already fired. Soft-deleted rows are never returned.

## Response `200`

Successful Response

- ListWorkerSchedulesResponse
  - `schedules` WorkerScheduleResponse[], required
    - `id` string, uuid, required
    - `worker_id` string, required
    - `name` string, required
    - `directive` string, required
    - `timing` union, required
      - OneShotScheduleTiming
        - `kind` 'one_shot', required
        - `datetime` string, date-time, required
        - `timezone` string, required
      - RecurringScheduleTiming
        - `kind` 'recurring', required
        - `cron_expression` string, required
        - `timezone` string, required
    - `created_by_user` WorkerScheduleUserResponse, required — Schedule creator: a Traversal user or a resolved Slack/Teams identity.
      - `id` string, required
      - `email` string, nullable, required
      - `name` string, nullable, required
      - `profile_photo_url` string, nullable, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `completed_at` string, date-time, nullable, required
  - `count` integer, required
  - `prev` integer, nullable
  - `next` integer, nullable
  - `total` integer, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/traversal/apis/fastapi.md) · [All operations](https://skmtc.dev/traversal/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/traversal/fastapi/revisions/01ca496f3b4f/schema)