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. Events are list-only rows (nothing addresses a single event); each carries
rule_uuid, the rule it belongs to.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.Deprecated: until the sunset this response also carries the legacy integer id and *_id fields. Don't use them; read uuid and the *_uuid fields.
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/019c12ab-1cf9-7acd-9ca4-e05a5284d4d8/events?limit=20" \
-H "X-API-KEY: <your_api_key>"
Response — 200 OK
{
"items": [
{
"rule_uuid": "019c12ab-1cf9-7acd-9ca4-e05a5284d4d8",
"status": "firing",
"value": 1.7,
"triggered_at": "2026-05-21T12:30:01Z",
"notified": true,
"notification_err": null
},
{
"rule_uuid": "019c12ab-1cf9-7acd-9ca4-e05a5284d4d8",
"status": "ok",
"value": 0.04,
"triggered_at": "2026-05-21T11:05:00Z",
"notified": true,
"notification_err": null
}
]
}
Was this helpful?