List Event History

Read the unified stored timeline of PDU event alerts, CMP device-connection observations, and custom-function action results. This reads event_logs history rather than the seven-day event_state snapshot view. Use explicit since/before bounds to select the desired time range. Timestamps filter by deviceTs, while sortBy may select deviceTs or receivedAt. Rows can retain their historical identity after a PDU event definition is deleted. Device name and connectionState are current presentation data, not a reconstruction of their historical values.

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
string

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

integer
≥ 1

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

string

Comma-separated PDU-local event IDs. Combine with a serial filter when targeting one PDU event.

string

Comma-separated stored event-code strings. This filters historical event_type, not the log kind.

string

Comma-separated log categories: event_alert, cmp_connection_event, custom_function_action_result. Requesting event_alert also includes cmp_connection_event for compatibility. Omit for all kinds.

string
enum

Only the exact strings true and false apply a state filter. When set, restricts results to event_alert/cmp_connection_event kinds and the corresponding triggered state, excluding custom-function results.

Allowed:

Case-insensitive match against event/action/script/error text or PDU serial and stored last-known device name.

int64

Inclusive lower bound on deviceTs as Unix epoch milliseconds. Supply a numeric timestamp, not an ISO date string. No time filter is applied when omitted.

int64

Inclusive upper bound on deviceTs as Unix epoch milliseconds. Supply a numeric timestamp, not an ISO date string.

string
enum
Defaults to deviceTs

Timestamp column used for ordering. Defaults to deviceTs for missing/unrecognized values.

Allowed:
string
enum
Defaults to desc

asc gives ascending order; any other/missing value uses desc. No secondary tie-break ordering is guaranteed.

Allowed:
integer
≥ 1
Defaults to 1

Positive page number; defaults to 1. Use positive values; this handler does not clamp out-of-range pages to the final page.

integer
≥ 1
Defaults to 20

Positive records-per-page value; defaults to 20. The current handler does not enforce a maximum page size.

Responses

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