> ## Documentation Index
> Fetch the complete documentation index at: https://docs.happyuptime.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List incidents

Paginate and filter incidents by status or severity.

# List incidents

GET `/incidents`

List incidents with pagination and filtering.

**Auth:** Bearer token (`read` scope)

## Query parameters

Page number.

Items per page.

Filter by status: `investigating`, `identified`, `monitoring`, `resolved`.

Filter by severity: `critical`, `major`, `minor`.

## Request

```bash cURL
curl https://happyuptime.com/api/v1/incidents \
  -H "Authorization: Bearer hu_your_api_key"
```

```bash CLI
happy incidents list
```

```javascript Node
const res = await fetch("https://happyuptime.com/api/v1/incidents", {
  headers: { "Authorization": "Bearer " + process.env.HAPPYUPTIME_API_KEY },
});
const { data } = await res.json();
```

## Response

```json
{
  "data": [
    {
      "id": "inc_847",
      "project_id": "proj_xyz",
      "title": "API latency spike",
      "status": "investigating",
      "severity": "major",
      "started_at": "2026-03-07T14:22:00Z",
      "resolved_at": null,
      "created_at": "2026-03-07T14:22:00Z",
      "updated_at": "2026-03-07T14:35:00Z"
    }
  ],
  "meta": {
    "page": 1,
    "per_page": 25,
    "total": 3,
    "total_pages": 1
  }
}
```