Skip to main content
API Explorer|API Explorer
Alerting & Response/Alert Events
GETAlertingSince 1.0SynchronousAuth Required

ListAlertEvents

List alert events with filtering by severity, state, time range, and more

Execution Availability

Try It Out

Submit a mock request using the current auth context and example-driven inputs.

Query Parameters

Request Inputs

Query Parameters

  • severityString

    Filter by severity level Filter by severity level

  • stateString

    Filter by event state Filter by event state

  • resourceTypeString

    Filter by resource type Filter by resource type

  • ruleUuidString

    Filter by rule UUID Filter by rule UUID

  • sourceString

    Filter by event source Filter by event source

Responses

200 OK

On success, this API returns the following response structure.

  • itemsList

    List of alert events

    Example: (nested array)

    • uuidString

      Unique identifier of the alert event

      Example: event-001

    • ruleUuidString

      UUID of the rule that generated this event

      Example: rule-abc123

    • ruleNameString

      Name of the rule that generated this event

      Example: High CPU Usage

    • resourceTypeString

      Type of monitored resource

      Example: vm

    • resourceUuidString

      UUID of the specific resource

      Example: res-abc123

    • metricNameString

      Metric name that was evaluated

      Example: cpu_usage_percent

    • currentValueLong

      Current metric value at the time of the event

      Example: 95.3

    • thresholdLong

      Threshold that was exceeded

      Example: 90

    • operatorString

      Comparison operator used

      Example: >

    • severityString

      Severity level of the event

      Example: critical

    • stateString

      Current state: firing, acknowledged, or resolved

      Example: firing

    • messageString

      Human-readable event message

      Example: CPU usage is 95.3%

    • fingerprintString

      Unique fingerprint for deduplication

      Example: fp-abc123

    • sourceString

      Source system that generated the event

      Example: prometheus

    • notifiedAtString

      Timestamp when the notification was sent

      Example: 2026-01-15T08:00:00Z

    • resolvedAtString

      Timestamp when the event was resolved

      Example: 2026-01-15T08:00:00Z

    • acknowledgedByString

      User who acknowledged this event

      Example: admin

    • acknowledgedAtString

      Timestamp when the event was acknowledged

      Example: 2026-01-15T08:00:00Z

    • createDateString

      Timestamp when the event was created

      Example: 2026-01-15T08:00:00Z

  • totalInteger

    Total number of matching events

    Example: 150

  • limitInteger

    Maximum items per page

    Example: 20

  • offsetInteger

    Offset from start of result set

    Example: 20

Endpoint

GET/api/v1/alerting/events

/api/v1/alerting/events

Operation ID

ListAlertEvents

Permalink

Request Example

curl -X GET '{host}/api/v1/alerting/events' -H 'Authorization: Bearer {token}'

Response Example

200
{
  "items": [
    {}
  ],
  "total": 150,
  "limit": 20,
  "offset": 20
}

Change History

This API has no change history records yet.

View all change history