Get paginated history of resolved and inactive alerts for a specific system.
Alerts are stored by the collect service when Alertmanager sends webhook notifications.
Requires read:systems permission.
Query parameters
-
Page number
Minimum value is
1. Default value is1. -
Items per page
Minimum value is
1, maximum value is200. Default value is20. -
Field to sort by
Values are
id,alertname,severity,status,starts_at,ends_at, orcreated_at. Default value iscreated_at. -
Sort direction
Values are
ascordesc. Default value isasc.
GET
/systems/{id}/alerts/history
curl \
--request GET 'https://api.your-domain.com/api/systems/sys_123456789/alerts/history' \
--header "Authorization: Bearer $ACCESS_TOKEN"
Response examples (200)
{
"code": 200,
"message": "alert history retrieved successfully",
"data": {
"alerts": [
{
"id": 1,
"system_key": "NETH-F5D2-5E69-A174-45A9-B1AB-2BB9-03F5-F1B4",
"alertname": "DiskFull",
"severity": "critical",
"status": "resolved",
"fingerprint": "ac193fc966f036ca",
"starts_at": "2026-04-08T13:28:38Z",
"ends_at": "2026-04-08T13:33:39Z",
"summary": "Disk usage above 90%",
"labels": {
"alertname": "DiskFull",
"severity": "critical",
"system_key": "NETH-F5D2-5E69-A174-45A9-B1AB-2BB9-03F5-F1B4"
},
"annotations": {
"summary": "Disk usage above 90%"
},
"receiver": "severity-critical-receiver",
"created_at": "2026-04-08T13:33:40Z"
}
],
"pagination": {
"page": 1,
"page_size": 20,
"total_count": 156,
"total_pages": 8,
"has_next": true,
"has_prev": false,
"next_page": 2,
"prev_page": 42,
"sort_by": "name",
"sort_direction": "asc"
}
}
}
Response examples (401)
{
"code": 401,
"message": "invalid token",
"data": {}
}
Response examples (403)
{
"code": 403,
"message": "insufficient permissions",
"data": {}
}
Response examples (404)
{
"code": 400,
"message": "validation failed",
"data": {
"type": "validation_error",
"errors": [
{
"key": "username",
"message": "required",
"value": "string"
}
]
}
}