---
title: "List alert events"
method: GET
path: "/v1/alert-events"
tags: ["alert-events"]
---

# List alert events

`GET /v1/alert-events`

## Request

- Base URL: `https://api.brixsignage.com`
- URL: `https://api.brixsignage.com/v1/alert-events`
- Auth: HTTP bearer

List alerts that have fired against your screens, each combined with the screen's name. This endpoint is read-only: alerts open automatically when a condition is detected and close automatically on recovery. Only currently open alerts are returned, as a limited list, so a long history does not push them out.

Open events (up to 300, newest first) followed by recently closed ones (up to 300). Not paginated.

**Notes.**
- The route-registry description names `alert-rule.view`, but the route is gated by `screen.view`; `screen.view` is what a key needs.

## Response `200`

Success.

- object
  - `data` AlertEvent[], required
    - `id` string, required: Alert event id.
    - `code` string, required: What fired, e.g. `connection-lost`, `display-off`, `storage-critical`.
    - `severity` string, required: `info`, `warning` or `critical`.
    - `screenId` string, required
    - `screenName` string, required: `(unknown screen)` if the screen is gone.
    - `message` string, required
    - `nextAction` string, required: Suggested next step; may be empty.
    - `openedAt` string, required: ISO-8601 timestamp (UTC).
    - `closedAt` string, nullable, required: ISO-8601 timestamp (UTC).
    - `detail` object, nullable, required: Structured detail keyed by `kind` (`recovery`, `outage-history`, `network-unstable`, `display-off`), or null.
      - `kind` string, required

## Other responses

- `401`: Missing, expired or revoked bearer token.
- `403`: The token lacks the permission this operation needs (see `x-brix-permission`).
- `5XX`: Server error. The body carries a `requestId` to quote to support.

---

[API](https://skmtc.dev/brixsignage/apis/brix-api.md) · [All operations](https://skmtc.dev/brixsignage/apis/brix-api/llms.txt) · [OpenAPI document](https://skmtc.dev/brixsignage/apis/brix-api/revisions/02fd3665dc7d?raw)