v51

latestOpenAPI 3.0.2raw.githubusercontent.com2026-08-01245104440.0 KB
Find

Get connection history

Query the connection history table for MAC address connection/disconnection events. Requires SYSTEM_ACCESS_SEARCH_NETWORK.

get/v1/connection-history

Query parameters

macAddressstring

Filter by MAC address.

nodeIdinteger

Filter by node ID (matches switch_id or node_id).

switchIdinteger

Filter by switch ID.

interfaceIdinteger

Filter by interface ID.

frominteger

Start of time range (unix timestamp).

tointeger

End of time range (unix timestamp).

limitinteger

Maximum number of records to return (default 1000, max 10000).

Response

Connection history records.

recordIdinteger

Record ID

timestampinteger

Event timestamp (unix)

macAddressstring

MAC address

ipAddressstring

IP address

nodeIdinteger

Node ID

switchIdinteger

Switch ID

interfaceIdinteger

Interface ID

vlanIdinteger

VLAN ID

eventTypeinteger

Event type

oldSwitchIdinteger

Previous switch ID

oldInterfaceIdinteger

Previous interface ID