# List Incidents — PagerDuty

> List and filter incidents by status, urgency, service, or team. Default statuses are triggered and acknowledged (open incidents). Use List Services to discover service IDs and List Teams for team IDs. Time params use ISO 8601 with explicit…

- Key: `pagerduty-list-incidents`
- Type: Action (Read-only)
- Version: 0.0.2
- App: PagerDuty (`pagerduty`) — https://pipedream.com/apps/pagerduty.md
- This page (HTML): https://pipedream.com/apps/pagerduty/actions/list-incidents
- Hints: read-only · open-world
- Source: https://github.com/PipedreamHQ/pipedream/blob/master/components/pagerduty/actions/list-incidents/list-incidents.mjs

## Description

List and filter incidents by status, urgency, service, or team. Default statuses are `triggered` and `acknowledged` (open incidents). Use **List Services** to discover service IDs and **List Teams** for team IDs. Time params use ISO 8601 with explicit UTC offset, e.g. `2026-06-02T15:00:00-07:00`. [See the documentation](https://developer.pagerduty.com/api-reference/9d0b4b12e36f9-list-incidents)

## Props

| Prop | Type | Required | Description |
|---|---|---|---|
| `statuses` | `string[]` | No | Filter by status. Options: triggered, acknowledged, resolved. Defaults to triggered and acknowledged. |
| `urgencies` | `string[]` | No | Filter by urgency. Options: high, low. |
| `teamIds` | `string[]` | No | Filter to incidents belonging to these teams. |
| `serviceIds` | `string[]` | No | Filter to incidents on these services. Use List Services to discover IDs. |
| `since` | `string` | No | Start of time range (ISO 8601 with UTC offset, e.g. 2026-06-02T15:00:00-07:00). |
| `until` | `string` | No | End of time range (ISO 8601 with UTC offset). |
| `limit` | `integer` | No | Maximum number of results to return (1–100). Default: 25. |
| `offset` | `integer` | No | Pagination offset. Default: 0. |

## Run it

**MCP**

```ts
import { Client } from "@modelcontextprotocol/sdk/client/index.js"
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js"
import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const accessToken = await pd.rawAccessToken

const transport = new StreamableHTTPClientTransport(
  new URL("https://remote.mcp.pipedream.net/v3"),
  {
    requestInit: {
      headers: {
        Authorization: `Bearer ${accessToken}`,
        "x-pd-project-id": process.env.PIPEDREAM_PROJECT_ID!,
        "x-pd-environment": "production",
        "x-pd-external-user-id": "{external_user_id}", // any stable ID for this user in your system
        "x-pd-app-slug": "pagerduty",
      },
    },
  },
)

const mcp = new Client({ name: "my-agent", version: "1.0.0" })
await mcp.connect(transport)

const { tools } = await mcp.listTools()

// listTools() hands your model this tool's input schema, so it can
// fill the arguments itself:
const result = await mcp.callTool({
  name: "pagerduty-list-incidents",
  arguments: {
    statuses: ["Statuses"],
    urgencies: ["Urgencies"],
  },
})
```

**TypeScript**

```ts
import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "pagerduty-list-incidents",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    pagerduty: { authProvisionId: "apn_xxxxxxx" },
    statuses: ["Statuses"],
    urgencies: ["Urgencies"],
  },
})

console.log(result)
```

**cURL**

```bash
curl -X POST https://api.pipedream.com/v1/connect/{project_id}/actions/run \
  -H "Content-Type: application/json" \
  -H "X-PD-Environment: production" \
  -H "Authorization: Bearer {access_token}" \
  -d '{
    "external_user_id": "{external_user_id}",
    "id": "pagerduty-list-incidents",
    "configured_props": {
      "pagerduty": { "authProvisionId": "apn_xxxxxxx" },
      "statuses": ["Statuses"],
      "urgencies": ["Urgencies"]
    }
  }'
```

---

- App: https://pipedream.com/apps/pagerduty.md · All apps: https://pipedream.com/apps