> ## 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 Teams

List teams of your PagerDuty account, optionally filtered by a search query.

A team is a collection of Users and Escalation Policies that represent a group of people within an organization.

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

<Note>
  External Documentation

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

## Basic Parameters

<div className="integrations-table">
  | Parameter | Description                                                             |
  | --------- | ----------------------------------------------------------------------- |
  | 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"}
{
	"summary": "Response Example",
	"value": {
		"limit": 100,
		"more": false,
		"offset": 0,
		"teams": [
			{
				"description": "All engineering",
				"html_url": "https://subdomain.pagerduty.com/teams/PQ9K7I8",
				"id": "PQ9K7I8",
				"name": "Engineering",
				"self": "https://api.pagerduty.com/teams/PQ9K7I8",
				"summary": "Engineering",
				"type": "team"
			}
		],
		"total": null
	}
}
```

## Workflow Library Example

[List Teams with Pagerduty and Send Results Via Email](https://library.blinkops.com/workflows/list-teams-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-teams-with-pagerduty-and-send-results-via-email/canvas" />
</div>