Skip to content

Alerts API

GET /v1/alerts

Returns up to 100 most recent alerts, newest first.

Query parameters

Param Type Description
status string Filter by active or resolved. Omit for both.

Example

Terminal window
curl "https://guardian.gtarsenals.com/v1/alerts?status=active" \
-H "Authorization: Bearer gtg_live_..."
{
"object": "list",
"data": [
{
"id": 4821,
"agent_id": "a1b2c3d4",
"hostname": "web-01",
"title": "Disk usage critical",
"message": "/var is at 96% capacity",
"severity": "critical",
"resolved": false,
"created_at": "2026-07-12T18:40:11Z"
}
]
}

hostname is "unknown" if the originating agent has since been removed.