Export Event History as CSV

Export the same authorized event-history filters and ordering as /v2/eventLogs. The export begins with the first matching row; page and limit do not select an export page. exportLimit defaults to 5000 and is capped at 5000; larger matches are truncated without a continuation cursor or total count in the CSV. An empty scope produces a header-only CSV. Columns are Kind, Event Name, Event Type, Status, Action Name, Script Name, Exit Code, Signal, Error Message, Device Serial, Device Name, Device Timestamp, Received At, Actions, and Params. Status is Active/Cleared for alerts, Offline/Online for CMP connection observations, or the reported custom-function status. Actions and Params are blank for custom-function results.

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 to 5000
Defaults to 5000

Maximum positive number of matching rows to export, starting with the first row in the selected sort order. Missing/zero/invalid values use 5000; values above 5000 are capped.

Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

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