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

# List worker schedules

`GET /api/workers/{workerId}/schedules`

List scheduled tasks for a worker.

## Path parameters

- `workerId` string, required

## Response `200`

Worker schedules.

- WorkerSchedules
  - `workerId` string, required
  - `timezone` string, required
  - `schedules` WorkerSchedule[], required
    - union
      - ScheduledWorkerSchedule
        - `id` string, required
        - `input` string, required
        - `budget` 'low' | 'standard' | 'high' | 'unlimited', required
        - `nextRunAt` string, date-time, required
        - `type` 'scheduled', required
      - DelayedWorkerSchedule
        - `id` string, required
        - `input` string, required
        - `budget` 'low' | 'standard' | 'high' | 'unlimited', required
        - `nextRunAt` string, date-time, required
        - `type` 'delayed', required
        - `delayInSeconds` integer, required
      - CronWorkerSchedule
        - `id` string, required
        - `input` string, required
        - `budget` 'low' | 'standard' | 'high' | 'unlimited', required
        - `nextRunAt` string, date-time, required
        - `type` 'cron', required
        - `cron` string, required
      - IntervalWorkerSchedule
        - `id` string, required
        - `input` string, required
        - `budget` 'low' | 'standard' | 'high' | 'unlimited', required
        - `nextRunAt` string, date-time, required
        - `type` 'interval', required
        - `intervalSeconds` integer, required

## Other responses

- `401` — Unauthorized.
- `403` — Forbidden.
- `429` — Rate limit exceeded.
- `500` — Internal server error.

## Changes

- **2026-07-10** `30dae1be3dc4` — 1 info
  - added the required property `timezone` to the response with the `200` status
- **2026-05-11** `689cce060c12` — 8 info
  - the `type` response property const value `cron` was added for the status `200`
  - the `type` response property const value `delayed` was added for the status `200`
  - the `type` response property const value `interval` was added for the status `200`
  - the `type` response property const value `scheduled` was added for the status `200`
  - …4 more

[Change history](https://skmtc.dev/ramensoft/apis/handinger-api/changes/api/workers/:workerId/schedules/get.md)

---

[API](https://skmtc.dev/ramensoft/apis/handinger-api.md) · [All operations](https://skmtc.dev/ramensoft/apis/handinger-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ramensoft/handinger-api/revisions/95b6b61a63ef/schema)