List Event States and Alert Summary

Scope reads to the PDUs you monitor using enclosure_serial_number or groupId. Add code for selected event types or triggered=true for active alerts. For example, use GET /v3/events?enclosure_serial_number=1000036&triggered=true&page=1&limit=25 for a single PDU. Skip the request if your device selection is empty. Pagination limits the response size. CMP still processes the matching scope before returning each page, so avoid frequent fleet-wide polling.

Read the paginated cached event-state view used by the CMP Alerts page. Only states whose stored last-change timestamp is within the preceding seven days are considered; there is no since/before parameter on this route. It is neither historical event logging nor the account audit API. Filters run over authorized devices and stored rows; connectionState reflects current CMP cache status. summary follows all filters; statusSummary is calculated before the triggered filter. Device totals describe the visible PDU scope. Pagination is applied to the filtered/sorted set. The current implementation clamps the start of the final slice, so final or out-of-range pages can overlap earlier rows; identify rows by enclosureSerialNumber plus id rather than assuming pages are disjoint.

Requires a CMP session bearer token or active personal access token. Results are limited to the caller's accessible PDUs under the existing viewEventInfo device/group-role rules. PDUs excluded by those rules are omitted rather than producing a per-device forbidden error; an empty visible scope returns an empty result.

Query Params
integer
≥ 1
Defaults to 1

Positive page number; defaults to 1 when missing or not a positive number. The current handler echoes the requested page even when clamping its final slice.

integer
1 to 100
Defaults to 25

Requested page size; defaults to 25 when missing or invalid and is capped at 100.

string

Comma-separated PDU serial numbers. Omit to consider all PDUs visible to the authenticated user; requested serials never broaden access.

string

Comma-separated numeric event codes, such as 12,31.

integer
≥ 1

Further restrict visible PDUs to serials included in this CMP group. Does not grant access to otherwise inaccessible PDUs.

string

Optional state filter. true, 1, or alert selects triggered rows; false, 0, or ok selects untriggered rows. Text values are case-insensitive. Other values apply no triggered filter.

Case-insensitive match against event name/reference name, PDU serial/name, and serialized event parameters. Trimmed before matching.

string
enum

eventName sorts by event name (default ascending); lastTriggered sorts by execution timestamp (default descending). Optional suffix asc or desc selects direction. With no valid sort key, triggered rows come first, then event name.

Allowed:
Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json