Skip to content

List incidents for a monitor

GET
/monitors/{monitor_id}/incidents
curl --request GET \
--url https://api.perstat.io/monitors/example/incidents \
--header 'Authorization: Bearer <token>'

Returns up to 50 recent incidents for the monitor, including status, severity, cause, affected regions, and start and resolution timestamps. Requires membership in the monitor’s organization. Accepts API keys with the incidents:read scope, subject to current role and resource grants.

monitor_id
required
string

Request succeeded. The response body contains the result.

Media typeapplication/json
Array<object>
object
cause
required
string
down_regions
required
Array<string>
id
required
string
monitor_id
required
string
monitor_name
string | null
project_name
string | null
region_count
required
integer format: int32
resolved_at_unix
integer | null format: int64
severity
required
string
started_at_unix
required
integer format: int64
status
required
string
Examplegenerated
[
{
"cause": "example",
"down_regions": [
"example"
],
"id": "example",
"monitor_id": "example",
"monitor_name": "example",
"project_name": "example",
"region_count": 1,
"resolved_at_unix": 1,
"severity": "example",
"started_at_unix": 1,
"status": "example"
}
]

Authentication is missing or invalid.

The authenticated caller does not have permission to perform this operation.

No accessible resource matches the supplied identifier.