List alerts

List monitor alerts, optionally filtering and sorting the response. Filters are specified in the CEL query language. Supported orderBy fields: id, level, status, start, monitor.id, monitor.label. Time scoping can be provided in two ways (mutually exclusive):

  • startTime/endTime: a time range. Alerts overlapping this range are returned. Defaults to the last 24 hours.
  • activeAt: a single timestamp. Returns alerts that were active at that moment. If both activeAt and startTime/endTime are provided, returns 400. Default page size is 200, maximum is 1000.
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string

Filter that response alerts must match. Specified in CEL format. Note that filter expressions must be URL encoded.

Supported filter fields:

  • id (string): unique alert identifier
  • level (string): one of Critical, Error, Warning, Informational, NoData, None
  • status (string): one of Active, Ended, Retracted
  • monitor.id (int): ID of the monitor that generated the alert
  • monitor.label (string): display label of the monitor (supports .contains(), .startsWith(), .endsWith())
  • muted (bool): whether the alert is muted (true / false)
  • context.<key> (string): context value by key, where <key> is a GroupBy column name from the monitor definition. Use dot notation to access context fields. Supports .contains(), .startsWith(), .endsWith().
string

A comma-separated list of field expressions to sort by. Prefix a field with - for descending order (default is ascending). Default sort is by start time, descending.

string

Start of the time range to query. Alerts that overlap this range are returned (i.e., alerts whose end time is after startTime, or that are still active). Defaults to 24 hours ago if not provided.

string

End of the time range to query. Alerts whose start time is before endTime are returned. Defaults to current time if not provided.

string

A single timestamp to query alerts that were active at that moment. Returns alerts where start <= activeAt and (end >= activeAt or the alert is still active). Mutually exclusive with startTime and endTime — if both are provided, returns 400.

int64

Number of items to skip before starting to collect the result set

int64

Maximum number of items to return in the response

boolean

Whether to expand resources referenced in the response to include additional fields

boolean

When true, the response includes faceted counts for key alert attributes, computed over all alerts in the requested time window. These counts ignore any filter, orderBy, offset, or limit parameters, making them suitable for building filter panels.

Responses

Language
Credentials
Bearer
Authorization: Bearer <customerid> <apitoken>
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json