---
title: "Get connection history"
method: GET
path: "/v1/connection-history"
tags: ["Find"]
---

# Get connection history

`GET /v1/connection-history`

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

## Query parameters

- `macAddress` string
- `nodeId` integer
- `switchId` integer
- `interfaceId` integer
- `from` integer
- `to` integer
- `limit` integer

## Response `200`

Connection history records.

- object[]
  - `recordId` integer — Record ID
  - `timestamp` integer — Event timestamp (unix)
  - `macAddress` string — MAC address
  - `ipAddress` string — IP address
  - `nodeId` integer — Node ID
  - `switchId` integer — Switch ID
  - `interfaceId` integer — Interface ID
  - `vlanId` integer — VLAN ID
  - `eventType` integer — Event type
  - `oldSwitchId` integer — Previous switch ID
  - `oldInterfaceId` integer — Previous interface ID

## Other responses

- `401` — Unauthorized
- `403` — User does not have SEARCH_NETWORK access

---

[API](https://skmtc.net/netxms/apis/netxms-api.md) · [All operations](https://skmtc.net/netxms/apis/netxms-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/netxms/netxms-api/versions/14d93e5115dd/schema)