# List PagerDuty incidents

Canonical URL: https://docs.fuse.init.inc/integrations/pagerduty/actions/incidents.list

List incidents for the bound PagerDuty account. Requires read. Returns one bounded page.

Action ID: `incidents.list`
Provider: PagerDuty (`pagerduty`)
Contract version: 1

## Risk and exposure

- Risk: Read
- Idempotency: Safe — Safe to retry without coordination; repeats do not create additional side effects.
- Availability: Default
- Exposure: REST, SDK, MCP
- MCP hints: readOnly=true, destructive=false, idempotent=true, openWorld=true

## Required scopes

- `read`

## Input schema fields

- `page_size`
- `cursor`

## Output schema fields

- `incidents`
- `incidents[]`
- `incidents[].id`
- `incidents[].incident_number`
- `incidents[].title`
- `incidents[].status`
- `incidents[].urgency`
- `incidents[].html_url`
- `incidents[].service`
- `incidents[].service.id`
- `incidents[].service.summary`
- `incidents[].service.html_url`
- `incidents[].service.type`
- `incidents[].assignments`
- `incidents[].assignments[]`
- `incidents[].assignments[].assignee`
- `incidents[].assignments[].assignee.id`
- `incidents[].assignments[].assignee.summary`
- `incidents[].assignments[].assignee.html_url`
- `incidents[].assignments[].assignee.type`
- `incidents[].assignments[].at`
- `incidents[].escalation_policy`
- `incidents[].escalation_policy.id`
- `incidents[].escalation_policy.summary`
- `incidents[].escalation_policy.html_url`
- `incidents[].escalation_policy.type`
- `incidents[].created_at`
- `incidents[].updated_at`
- `incidents[].resolved_at`
- `next_cursor`

Provider overview: https://docs.fuse.init.inc/integrations/pagerduty
Actions index: https://docs.fuse.init.inc/integrations/pagerduty/actions
Exact canonical JSON contract: https://docs.fuse.init.inc/api/catalog/v1/providers/pagerduty/actions/incidents.list
Deployment-effective discovery: https://api.fuse.init.inc/v1/tenants/%7Btenant_id%7D/providers/pagerduty/actions