Sign in

v1

latestOpenAPI 3.0.32026-07-131670112.4 KB
Alerts

List alerts

Returns alerts for the authenticated user, newest first. Filter by status or severity.

get/v1/alerts

Query parameters

status'firing' | 'acked' | 'resolved'
severity'info' | 'warning' | 'critical'
limitinteger
pageinteger

Response

Default Response

alertsobject[]
totalinteger

Example response

{
  "alerts": [
    {
      "Id": 1,
      "title": "Pressure sensor offline",
      "body": "Sensor unit-7 at Site Alpha has not reported in 5 minutes.",
      "severity": "critical",
      "source": "sensor",
      "source_ref": "sensor-unit-7",
      "status": "firing",
      "user_id": 1,
      "org_id": 3,
      "ticket_id": null,
      "lat": 35.4676,
      "lng": -97.5164,
      "location_name": "Site Alpha",
      "meta": null,
      "fired_at": "2026-03-24T12:00:00Z",
      "acked_at": null,
      "resolved_at": null
    }
  ],
  "total": 1
}