---
title: "List schedules"
method: GET
path: "/api/v1/schedules"
tags: ["Schedules"]
---

# List schedules

`GET /api/v1/schedules`

## Request

- Base URL: `https://volunteerreminder.com`
- URL: `https://volunteerreminder.com/api/v1/schedules`
- Auth: HTTP bearer

All active (non-archived) schedules for the account. Requires the `read` scope.

## Response `200`

The account's schedules.

- ScheduleSummary[]
  - `id` number, required: Schedule id.
  - `description` string, required: Schedule label.
  - `job_id` number, required: Job/role id (use for per-job reminder overrides).
  - `job_name` string, nullable, required: Associated job/role name.
  - `group_name` string, nullable, required: Associated group name, or null.
  - `notes` string, nullable, required: Free-text internal notes.
  - `next_occurrence_at` number, nullable, required: Epoch ms (UTC) of the next upcoming, attendable occurrence, or null.
  - `last_reminder_sent` number, nullable, required: Epoch ms (UTC) reminders were last sent for this schedule, or null.
  - `roster_count` number, required: Number of volunteers assigned to this schedule.

## Other responses

- `401`: Missing or invalid API key.
- `403`: The API key lacks a scope required by this endpoint.

---

[API](https://skmtc.dev/volunteerreminder/apis/volunteerreminder-api.md) · [All operations](https://skmtc.dev/volunteerreminder/apis/volunteerreminder-api/llms.txt) · [OpenAPI document](https://skmtc.dev/volunteerreminder/apis/volunteerreminder-api/revisions/f8e7e26ba96f?raw)