Skip to main content

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.

External Documentation

To learn more, visit the PagerDuty documentation.

Basic Parameters

ParameterDescription
QueryFilters the result, showing only the tags whose labels match the query.

Advanced Parameters

ParameterDescription
LimitThe number of results per page.
OffsetOffset to start pagination search results.
TotalBy 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 for more information.

Example Output

{
"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

Workflow LibraryPreview this Workflow on desktop