---
title: "List schedules"
method: GET
path: "/v3/schedules"
tags: ["Schedules_v3"]
---

# List schedules

`GET /v3/schedules`

<!-- theme: info -->

> **Important note:** Shift-based schedules use the V3 API and are not compatible with V2 automations. **To create automations for Shift-Based Schedules, you need to:**
>
> 1. **Update your automations** to use the V3 API for all new shift-based schedules
> 2. **Keep the V2 endpoint** for your existing schedules
>
> An upgrade tool for existing schedules is coming soon; your legacy schedules will keep working in the meantime. [Learn more](https://support.pagerduty.com/main/docs/shift-based-schedules-api-upgrade-examples).

Retrieve a paginated list of schedule references. Returns lightweight
objects without embedded rotations or events.

Each result is filtered by the caller's read permission; schedules the
caller cannot read are silently excluded.

## Query parameters

- `limit` integer
- `offset` integer
- `query` string
- `total` boolean
- `team_ids[]` string[]

## Response `200`

Schedules retrieved successfully

- object
  - `schedules` V3ScheduleReference[], required
    - `id` string, required
    - `type` 'schedule_v3_reference', required
    - `summary` string, required — Schedule name
    - `self` string, uri
    - `html_url` string, uri
  - `limit` integer
  - `offset` integer
  - `more` boolean — Whether additional results exist beyond this page

## Other responses

- `400` — Bad Request — The request contains invalid parameters or data
- `401` — Caller did not supply credentials or did not provide the correct credentials. If you are using an API key, it may be invalid or your Authorization header may be malformed.
- `403` — Caller is not authorized to view the requested resource. While your authentication is valid, the authenticated user or token does not have permission to perform this action.
- `500` — Internal Server Error the PagerDuty server experienced an error.

---

[API](https://skmtc.net/pagerduty/apis/rest-api.md) · [All operations](https://skmtc.net/pagerduty/apis/rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pagerduty/rest-api/versions/b679a8f3f02c/schema)