Overview
Retrieves a paginated list of all services in your PagerDuty account. You can filter services by name or team membership.
This is a read-only tool. It retrieves data without modifying your PagerDuty account.
Parameters
Query parameters for filtering and pagination.
Filters the results, showing only the services whose name matches the query string.Example: "production"
Filter services by team IDs. Only services associated with these teams will be returned.Example: ["PTEAM1", "PTEAM2"]
Maximum number of results to return. Must be between 1 and 100.Default: 20
Response
Returns a ListResponseModel[Service] containing an array of services.
Array of Service objects matching the query parameters.
The unique identifier for the service.
The type of the object (always "service").
The description of the service.
escalation_policy
EscalationPolicyReference
required
Reference to the escalation policy associated with this service.Show EscalationPolicyReference
The ID of the escalation policy.
The type (always "escalation_policy_reference").
A short summary of the escalation policy (read-only, server-generated).
List of teams associated with the service.
The type (always "team_reference").
A short summary of the team.
A human-readable summary of the response including the count and type of records returned.
Example Usage
Example Response
{
"response": [
{
"id": "PSERVICE1",
"type": "service",
"name": "Production Web Service",
"description": "Main web application service",
"escalation_policy": {
"id": "PEPOLICY1",
"type": "escalation_policy_reference",
"summary": "Production Escalation Policy"
},
"teams": [
{
"id": "PTEAM1",
"type": "team_reference",
"summary": "Engineering Team"
}
]
},
{
"id": "PSERVICE2",
"type": "service",
"name": "Production Database Service",
"description": "PostgreSQL database cluster",
"escalation_policy": {
"id": "PEPOLICY1",
"type": "escalation_policy_reference",
"summary": "Production Escalation Policy"
},
"teams": [
{
"id": "PTEAM1",
"type": "team_reference",
"summary": "Engineering Team"
}
]
}
],
"response_summary": "ListResponseModel<Service>:\n- Returned 2 record(s) of type 'Service'."
}
get_service
Retrieve a specific service by ID
create_service
Create a new service
update_service
Update an existing service
list_incidents
List incidents for services