List Alert Events
Returns the recent state-transition events the evaluator has recorded for a rule. Each event is one of:
- ok → firing — the threshold was crossed; a notification is dispatched.
- firing → ok — the value returned to a healthy range.
Used by the dashboard's events drawer; also useful as an audit trail when post-mortem-ing a paging incident.
Path parameters
uuid string (uuid) Req
Alert rule UUID.
Query parameters
limit int
Maximum number of events to return. Server caps it; pass 0 or omit for the default cap.
Response (200 OK)
items array<Event>
Most recent first.
items[].status enum
One of:
firing— threshold was crossed; a notification was dispatched on this transition.ok— value returned to a healthy range; "resolved" notification dispatched.test— recorded when the user clicked the Test button; one-shot test notification (does not change the rule'sstatusfield).
test appears only on event rows. The rule's own status field is always unknown / ok / firing — never test.
items[].value number
The observed metric value at the transition.
items[].triggered_at timestamp
RFC 3339.
items[].notified boolean
Whether the worker successfully dispatched the notification.
items[].notification_err string (nullable)
Last delivery error when
notified is false. Null on success.Errors
401 Unauthorized
Missing auth.
404 Not Found
No rule with that UUID owned by the caller.
Request
curl "https://api.ngris.com/v1/traffic/alerts/<uuid>/events?limit=20" \
-H "X-API-KEY: <your_api_key>"
Response — 200 OK
{
"items": [
{
"id": 42,
"rule_id": 7,
"status": "firing",
"value": 1.7,
"triggered_at": "2026-05-21T12:30:01Z",
"notified": true,
"notification_err": null
},
{
"id": 41,
"rule_id": 7,
"status": "ok",
"value": 0.04,
"triggered_at": "2026-05-21T11:05:00Z",
"notified": true,
"notification_err": null
}
]
}