---
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` string — IP address in text form. Omitted entirely for unset (AF_UNSPEC) addresses.
    - `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.

## Changes

- **2026-08-17** `070b10a450e2` — 1 breaking
  - the `items/localIpAddress/address` response's property type/format changed from `integer`/`` to `string`/`` for status `200`
- **2026-08-12** `595d08199040` — 1 breaking
  - the `items/localIpAddress/address` response's property type/format changed from `string`/`` to `integer`/`` for status `200`
- **2026-08-12** `47655614e52c` — 1 breaking
  - the `items/localIpAddress/address` response's property type/format changed from `integer`/`` to `string`/`` for status `200`

[Change history](https://skmtc.dev/netxms/apis/netxms-api/changes/v1/find/mac-address/get.md)

---

[API](https://skmtc.dev/netxms/apis/netxms-api.md) · [All operations](https://skmtc.dev/netxms/apis/netxms-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/netxms/netxms-api/revisions/b04ea2fbcedb/schema)