> Documentation index for AI agents: https://docs.pagerduty.com/llms.txt

# Get Paused Incident Reporting on Alerts

`GET https://api.pagerduty.com/paused_incident_reports/alerts`

Returns the 5 most recent alerts that were triggered after being paused and the 5 most recent alerts that were resolved after being paused for a given reporting period (maximum 6 months lookback period).  Note: This feature is currently available as part of the Event Intelligence package or Digital Operations plan only.

For more information see the [API Concepts Document](https://docs.pagerduty.com/developer/api-concepts#paused-incident-reports)

Scoped OAuth requires: `incidents.read`

## Authorization

- **api_key** (apiKey) — `Authorization` header. The API Key with format `Token token=<API_KEY>`

## Query parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `since` | string (date-time) |  | The start of the date range over which you want to search. |
| `until` | string (date-time) |  | The end of the date range over which you want to search. |
| `service_id` | string |  | Specifies a filter to limit the scope of reporting to a particular service. |
| `suspended_by` |  |  | Specifies a filter to scope the response to either alerts suspended by Auto Pause or Event Rules. One of: `auto_pause`, `rules`. |

## Header parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `Accept` | string | yes | The `Accept` header is used as a versioning header. Default: `application/vnd.pagerduty+json;version=2`. |

## Response 200

Paused Incident Reporting on Alerts for the Account or scoped to a Service.

### `application/json`

| Field | Type | Required | Description |
|---|---|---|---|
| `paused_incident_reporting_alerts` | object |  | A list of the 5 most recent paused Alerts that weere triggered and 5 most recent Alerts that were reesolved before being triggerd. |
| `paused_incident_reporting_alerts.since` | string |  | The start of the date range over which the report data is represented. |
| `paused_incident_reporting_alerts.until` | string |  | The end of the date range over which the report data is represented. |
| `paused_incident_reporting_alerts.triggered_after_pause_alerts` | array of object |  | An array of Alerts that were triggered after being paused. |
| `paused_incident_reporting_alerts.triggered_after_pause_alerts[].id` | string |  | The Alert ID. |
| `paused_incident_reporting_alerts.triggered_after_pause_alerts[].service_id` | string |  | The Alert's Service ID. |
| `paused_incident_reporting_alerts.triggered_after_pause_alerts[].created_at` | string |  | The date/time the Alert was created. |
| `paused_incident_reporting_alerts.resolved_after_pause_alerts` | array of object |  | An array of Alerts that were resolved after being paused. |
| `paused_incident_reporting_alerts.resolved_after_pause_alerts[].id` | string |  | The Alert ID. |
| `paused_incident_reporting_alerts.resolved_after_pause_alerts[].service_id` | string |  | The Alert's Service ID. |
| `paused_incident_reporting_alerts.resolved_after_pause_alerts[].created_at` | string |  | The date/time the Alert was created. |

Example: Response Example

```json
{
  "paused_incident_reporting_counts": {
    "since": "2021-06-01TT13:08:14Z",
    "until": "2021-08-01T13:08:14Z",
    "triggered_after_pause_alerts": [
      {
        "id": "PR2P3RW",
        "service_id": "PPSCXAN",
        "created_at": "2020-10-18T12:01:11Z"
      }
    ],
    "resolved_after_pause_alerts": [
      {
        "id": "PS2R1RZ",
        "service_id": "PRS12XW",
        "created_at": "2020-10-17T02:02:10Z"
      },
      {
        "id": "PS1S1SX",
        "service_id": "PRS12XW",
        "created_at": "2020-10-16T15:02:19Z"
      }
    ]
  }
}
```

## Response 400

Caller provided invalid arguments. Please review the response for error details. Retrying with the same arguments will *not* work.

### `application/json`

| Field | Type | Required | Description |
|---|---|---|---|
| `error` | object |  |  |
| `error.code` | integer |  | Read-only. |
| `error.message` | string |  | Error message string. Read-only. |
| `error.errors` | array of string |  | Read-only. |

## Response 403

Caller is not authorized to view the requested resource.
While your authentication is valid, the authenticated user or token does not have permission to perform this action.

### `application/json`

| Field | Type | Required | Description |
|---|---|---|---|
| `error` | object |  |  |
| `error.code` | integer |  | Read-only. |
| `error.message` | string |  | Error message string. Read-only. |
| `error.errors` | array of string |  | Read-only. |

## Response 404

The requested resource was not found.

### `application/json`

| Field | Type | Required | Description |
|---|---|---|---|
| `error` | object |  |  |
| `error.code` | integer |  | Read-only. |
| `error.message` | string |  | Error message string. Read-only. |
| `error.errors` | array of string |  | Read-only. |

## Response 429

Too many requests have been made, the rate limit has been reached.

### `application/json`

| Field | Type | Required | Description |
|---|---|---|---|
| `error` | object |  |  |
| `error.code` | integer |  | Read-only. |
| `error.message` | string |  | Error message string. Read-only. |
| `error.errors` | array of string |  | Read-only. |

## Response 500

Internal Server Error the PagerDuty server experienced an error.

### `application/json`

| Field | Type | Required | Description |
|---|---|---|---|
| `error` | object |  |  |
| `error.code` | integer |  | Read-only. |
| `error.message` | string |  | Error message string. Read-only. |
| `error.errors` | array of string |  | Read-only. |

## Developer Agreement

Your access to and use of the PagerDuty Developer Services is governed by the [PagerDuty Developer Agreement](https://docs.pagerduty.com/developer/pagerduty-developer-agreement).