Skip to main content

​
Overview

Retrieves a list of on-call schedules from your PagerDuty account with support for filtering by name, team, user, and other criteria.
This is a read-only tool that does not modify any data in your PagerDuty account.

​
Parameters

All parameters are optional and can be combined to filter results:
​
query
string
Filter schedules by name or description. Partial matches are supported.
​
team_ids
array of strings
Filter schedules by team IDs. Returns schedules associated with the specified teams.
​
user_ids
array of strings
Filter schedules by user IDs. Returns schedules that include the specified users.
​
include
array of strings
Include additional details in the response. Supported values:
  • schedule_layers - Include the schedule layer details
​
limit
integer
default:"25"
Maximum number of schedules to return. Must be between 1 and 100.

​
Response

Returns a list of schedule objects. Each schedule includes:
​
id
string
The unique identifier for the schedule
​
name
string
The name of the schedule
​
summary
string
A short description of the schedule
​
description
string
The full description of the schedule
​
time_zone
string
The time zone of the schedule (IANA format, e.g., “America/New_York”)
​
html_url
string
The URL to view the schedule in PagerDuty
​
users
array
List of users associated with this schedule
​
teams
array
List of teams associated with this schedule
​
schedule_layers
array
List of schedule layers (only included if requested via the include parameter)

​
Example Usage

​
List all schedules

Show me all on-call schedules

​
Filter by team

List schedules for the infrastructure team

​
Search by name

Find schedules with "production" in the name

​
Get schedules with layer details

Show me all schedules including their layer information

​
Common Use Cases

  • Audit schedules - Review all on-call schedules configured in your account
  • Find specific schedules - Locate schedules by team, user, or name
  • Team planning - Identify which teams have on-call coverage
  • Schedule analysis - Examine schedule configurations and rotations

get_schedule

Get details for a specific schedule

list_oncalls

Check who is currently on-call

create_schedule

Create a new schedule (write mode)

update_schedule

Modify an existing schedule (write mode)

Build docs developers (and LLMs) love

Get started for freeTalk to us