Skip to main content
GET
List a monitor's alerts

Authorizations

Authorization
string
header
required

API key authorization. Pass your API key in the Authorization header as a Bearer token. Both new (gsk_*) and legacy (gsk-) API keys are accepted, e.g. Authorization: Bearer gsk_... or Authorization: Bearer gsk-....

Path Parameters

monitorId
string
required

Monitor ID

Example:

"monitor_123"

Query Parameters

state
enum<string>

Only open or only closed alerts

Available options:
OPEN,
CLOSED
Example:

"OPEN"

ruleIds
string[]

Only alerts opened by these rules

from
string<date-time>

Only alerts still open at or after this time (ISO 8601)

to
string<date-time>

Only alerts opened at or before this time (ISO 8601)

limit
integer
default:100

Maximum number of results

Required range: 0 <= x <= 1000
offset
integer
default:0

Number of results to skip

Required range: x >= 0

Response

Alerts retrieved successfully

id
string
required
Example:

"monitorAlert_123"

monitorId
string
required
Example:

"monitor_123"

ruleId
string
required
Example:

"monitorAlertRule_123"

ruleDeletedAt
string<date-time> | null
required

Set when the rule that opened the alert was deleted

state
enum<string>
required
Available options:
OPEN,
CLOSED
Example:

"OPEN"

openedAt
string<date-time>
required
closedAt
string<date-time> | null
required
closeReason
enum<string> | null
required
Available options:
RECOVERED,
RULE_DELETED,
RULE_EDITED,
RULE_PAUSED,
null
Example:

null

window
enum<string>
required
Available options:
FIFTEEN_MINUTES,
ONE_HOUR,
SIX_HOURS,
TWENTY_FOUR_HOURS
Example:

"ONE_HOUR"

windowStart
string<date-time>
required

Start of the window the check counted when the alert opened

windowEnd
string<date-time>
required

End of that window

metricGroupId
string
required

The metric family the rule watches

Example:

"metricGroup_123"

metricId
string
required

The metric revision the check counted

Example:

"metric_123"

samplingPercentage
number | null
required

The monitor's sampling rate

Example:

5

threshold
number
required

The threshold that opened the alert

Example:

10

clearValue
number | null
required

The value at which an open alert closes, from the rule's current settings. Null when the alert is closed, its rule was deleted, or its rule's metric family, window or bad session score changed. After a threshold-only edit it holds the new clear value.

Example:

6

observation
object
required

What the check saw when the alert opened. The fields depend on the rule type.