---
title: "Get switch forwarding database"
method: GET
path: "/v1/objects/{object-id}/switch-forwarding-database"
tags: ["Objects"]
---

# Get switch forwarding database

`GET /v1/objects/{object-id}/switch-forwarding-database`

Read the switch forwarding database (FDB) of the given node. Applicable to bridge-capable nodes. Returns an empty entry list with a null timestamp when the forwarding database has never been collected for this node.

## Path parameters

- `object-id` integer, required

## Response `200`

Switch forwarding database retrieved successfully

- SwitchForwardingDatabase — Switch forwarding database (FDB) of a node
  - `timestamp` string, date-time, nullable — When the forwarding database was collected. Null when it has never been collected for this node.
  - `entries` ForwardingDatabaseEntry[]
    - `macAddress` string — MAC address in colon-separated notation
    - `vendor` string, nullable — NIC vendor resolved from the OUI database. Null when the prefix is not known.
    - `bridgePort` integer — Bridge port number (0 if unknown)
    - `interfaceIndex` integer — Interface index (0 if unknown)
    - `interfaceName` string, nullable — Name of the matching interface object. Members of an Ethernet or LAG parent interface are reported under the parent's name. Null when no interface object matches the index.
    - `vlanId` integer — VLAN ID (0 if unknown)
    - `nodeId` integer — ID of the node owning this MAC address, or 0 when no node matches or the caller has no read access to it.
    - `nodeName` string, nullable — Name of the node owning this MAC address. Null when nodeId is 0.
    - `type` integer — Entry type, dot1dTpFdbStatus (3=dynamic, 5=static, 6=secure)
    - `typeText` string — Textual representation of the entry type

## Other responses

- `400` — Invalid object ID or object is not a node
- `401` — Unauthorized
- `403` — User does not have read access to given object
- `404` — Object with given ID does not exist

---

[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/revisions/070b10a450e2/schema)