Skip to main content
GET
List incidents for the authenticated org

Authorizations

Authorization
string
header
required

API key (dh_live_...) or Auth0 JWT token

Headers

X-DevHelm-Client
string

Calling surface and version, e.g. cli/1.4.0 or sdk-js/2.0.0

Query Parameters

status
enum<string>

Filter by incident lifecycle status; null returns every status

Available options:
WATCHING,
TRIGGERED,
CONFIRMED,
RESOLVED
severity
enum<string>

Filter by severity; null returns every severity

Available options:
DOWN,
DEGRADED,
MAINTENANCE
source
enum<string>

Filter by where the incident originated (auto, manual, third-party)

Available options:
AUTOMATIC,
MANUAL,
MONITORS,
STATUS_DATA,
RESOURCE_GROUP
monitorId
string<uuid>

Only return incidents tied to this monitor ID

serviceId
string<uuid>

Only return incidents tied to this service ID (third-party services)

resourceGroupId
string<uuid>

Only return incidents owned by this resource group (incidents.resource_group_id)

tagId
string<uuid>

Only return incidents whose monitor carries this tag

environmentId
string<uuid>

Only return incidents whose monitor lives in this environment

excludeId
string<uuid>

Exclude this incident ID from results (related-incident lists)

startedFrom
string<date-time>

Earliest startedAt to include (inclusive, ISO 8601)

startedTo
string<date-time>

Latest startedAt to include (inclusive, ISO 8601)

Case-insensitive substring match on title or incident ID

Maximum string length: 200
page
integer<int32>

Zero-based page index (default: 0)

Required range: x >= 0
Example:

0

size
integer<int32>

Number of incidents per page (1–200, default: 10)

Required range: 1 <= x <= 200
Example:

10

Response

OK

data
object[]
required
hasNext
boolean
required
hasPrev
boolean
required
totalElements
integer<int64> | null
totalPages
integer<int32> | null