> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blinkops.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Schedules

List the on-call schedules.

A Schedule determines the time periods that users are On-Call.

For more information see the [API Concepts Document](https://developer.pagerduty.com/api-reference/a47605517c19a-api-concepts#schedules).

<Note>
  External Documentation

  To learn more, visit the [PagerDuty documentation](https://developer.pagerduty.com/api-reference/846ecf84402bb-list-schedules).
</Note>

## Basic Parameters

<div className="integrations-table">
  | Parameter | Description                                                             |
  | --------- | ----------------------------------------------------------------------- |
  | Include   | Array of additional details to include.                                 |
  | Query     | Filters the result, showing only the tags whose labels match the query. |
</div>

## Advanced Parameters

<div className="integrations-table">
  | Parameter | Description                                                                                                                                                                                                                                                                               |
  | --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | Limit     | The number of results per page.                                                                                                                                                                                                                                                           |
  | Offset    | Offset to start pagination search results.                                                                                                                                                                                                                                                |
  | Total     | By default the `total` field in pagination responses is set to `null` to provide the fastest possible response times. Set `total` to `true` for this field to be populated. See our [Pagination Docs](https://developer.pagerduty.com/docs/rest-api-v2/pagination/) for more information. |
</div>

## Example Output

```json theme={"dark"}
{
	"value": {
		"limit": 100,
		"more": false,
		"offset": 0,
		"schedules": [
			{
				"description": "Rotation schedule for engineering",
				"escalation_policies": [
					{
						"html_url": "https://subdomain.pagerduty.com/escalation_policies/PT20YPA",
						"id": "PT20YPA",
						"self": "https://api.pagerduty.com/escalation_policies/PT20YPA",
						"summary": "Another Escalation Policy",
						"type": "escalation_policy_reference"
					}
				],
				"html_url": "https://subdomain.pagerduty.com/schedules/PI7DH85",
				"id": "PI7DH85",
				"name": "Daily Engineering Rotation",
				"self": "https://api.pagerduty.com/schedules/PI7DH85",
				"summary": "Daily Engineering Rotation",
				"time_zone": "America/New_York",
				"type": "schedule",
				"users": [
					{
						"html_url": "https://subdomain.pagerduty.com/users/PEYSGVF",
						"id": "PEYSGVF",
						"self": "https://api.pagerduty.com/users/PEYSGVF",
						"summary": "PagerDuty Admin",
						"type": "user_reference"
					}
				]
			}
		],
		"total": null
	}
}
```

## Workflow Library Example

[List Schedules with Pagerduty and Send Results Via Email](https://library.blinkops.com/workflows/list-schedules-with-pagerduty-and-send-results-via-email)

<div className="iframe-wrapper">
  <div className="iframe-media">
    <img src="https://mintcdn.com/blinkops-2/ojHYuDeYX5FWuN8a/img/Icons/play-box.svg?fit=max&auto=format&n=ojHYuDeYX5FWuN8a&q=85&s=b8af968e71438a9499c3223c9bd29fb2" alt="Workflow Library" width="16" height="16" data-path="img/Icons/play-box.svg" />

    Preview this Workflow on desktop
  </div>

  <iframe className="iframe" src="https://library.blinkops.com/workflows/list-schedules-with-pagerduty-and-send-results-via-email/canvas" />
</div>