---
title: "List issues"
method: GET
path: "/api/issues"
tags: ["issues"]
---

# List issues

`GET /api/issues`

## Request

- Base URL: `https://cronitor.io`
- URL: `https://cronitor.io/api/issues`
- Auth: HTTP basic

## Query parameters

- `check` string[]
- `component` string[]
- `env` string
- `group` string[]
- `heartbeat` string[]
- `job` string[]
- `orderBy` '-relevance' | '-started' | 'relevance' | 'started'
- `page` integer
- `pageSize` integer
- `search` string
- `severity` string[]
- `site` string[]
- `state` string[]
- `statuspage` string
- `tag` string[]
- `time` string
- `type` string[]
- `withAlertDetails` boolean
- `withComponentDetails` boolean
- `withEnvironmentDetails` boolean
- `withMonitorDetails` boolean
- `withStatusPageDetails` boolean
- `withSummary` boolean

## Headers

- `Cronitor-Version` '2025-11-28' | '2020-10-01'

## Response `200`

- PaginatedIssueList
  - `page` integer, required
  - `page_count` integer, required
  - `page_size` integer, required
  - `total_count` integer, required
  - `data` Issue[], required
    - `key` string, required
    - `name` string, required
    - `severity` union
      - 'missing_data' | 'operational' | 'maintenance' | 'degraded_performance' | 'minor_outage' | 'outage': * `missing_data` - missing_data * `operational` - operational * `maintenance` - maintenance * `degraded_performance` - degraded_performance * `minor_outage` - minor_outage * `outage` - outage
      - unknown
    - `state` 'unresolved' | 'investigating' | 'identified' | 'monitoring' | 'resolved' | 'update': * `unresolved` - unresolved * `investigating` - investigating * `identified` - identified * `monitoring` - monitoring * `resolved` - resolved * `update` - update
    - `updates` IncidentUpdate[]
      - `key` string
      - `timestamp` string, date-time
      - `message` string
      - `state` 'unresolved' | 'investigating' | 'identified' | 'monitoring' | 'resolved' | 'update': * `unresolved` - unresolved * `investigating` - investigating * `identified` - identified * `monitoring` - monitoring * `resolved` - resolved * `update` - update
      - `created` string, date-time, required
      - `updated` string, date-time, required
      - `created_by` string, email, nullable
    - `started` string, date-time
    - `ended` string, date-time, nullable, required
    - `duration` integer, required: Seconds of downtime.
    - `statuspages` string[]: Status page keys.
    - `affected_components` string[]: Status page component keys.
    - `monitors` object[], nullable, required: Null unless withMonitorDetails=true, which includes monitor details.
      - `key` string
      - `name` string
    - `alerts` object[], nullable, required: Present with withAlertDetails=true.
    - `environment` string: Environment key.
    - `created_by` unknown, required
    - `assigned_to` string, email, nullable: Email address of the assigned team member.
    - `created` string, date-time, required
    - `updated` string, date-time, required

---

[API](https://skmtc.dev/cronitor/apis/cronitor-api.md) - [All operations](https://skmtc.dev/cronitor/apis/cronitor-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cronitor/apis/cronitor-api/revisions/62fb38ef4462?raw)