---
title: "Find MAC address"
method: GET
path: "/v1/find/mac-address"
tags: ["Find"]
---

# Find MAC address

`GET /v1/find/mac-address`

## Query parameters

- `macAddress` string, required — Mac address or it's first part for search.
- `searchLimit` integer — Optional. Number of results to be returned, default is 100.
- `includeObjects` boolean — Optional. If provided, object information is included in response.

## Response `200`

Successful search of MAC address.

- object[]
  - `localMacAddress` string — Local mac address
  - `localNodeId` integer — Local node id
  - `localInterfaceId` integer — Local interface ID
  - `localIpAddress` InetAddress
    - `family` integer — IP address family
    - `address` integer — IP address
    - `prefixLength` integer — IP address prefix length
  - `type` string — Connection type
  - `nodeId` integer — Node or access point ID
  - `interfaceId` integer — Interface ID
  - `interfaceIndex` integer — Interface index

## Other responses

- `401` — Unauthorized.

---

[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)