---
title: "Get MIB node by OID"
method: GET
path: "/v1/snmp-mib/{oid}"
tags: ["SNMP MIB"]
---

# Get MIB node by OID

`GET /v1/snmp-mib/{oid}`

Retrieve the MIB node identified by the given OID, including its immediate children. The OID is a dotted numeric path with no leading dot (for example `1.3.6.1.2.1.1.1`).

## Path parameters

- `oid` string, required

## Response `200`

MIB node retrieved successfully

- MibNode — A node in the SNMP MIB tree, including its immediate children.
  - `oid` string — Full dotted OID for this node. Empty string for the synthetic root.
  - `name` string, nullable — Symbolic name of the node (e.g. `sysDescr`). Null if the node has no name (synthetic root).
  - `type` 'OTHER' | 'IMPORT_ITEM' | 'OBJID' | 'BITSTRING' | 'INTEGER' | 'INTEGER32' | 'INTEGER64' | 'UNSIGNED32' | 'COUNTER' | 'COUNTER32' | 'COUNTER64' | 'GAUGE' | 'GAUGE32' | 'TIMETICKS' | 'OCTETSTR' | 'OPAQUE' | 'IPADDR' | 'PHYSADDR' | 'NETADDR' | 'NAMED_TYPE' | 'SEQID' | 'SEQUENCE' | 'CHOICE' | 'TEXTUAL_CONVENTION' | 'MACRO_DEFINITION' | 'MODCOMP' | 'TRAPTYPE' | 'NOTIFTYPE' | 'MODID' | 'NSAPADDRESS' | 'AGENTCAP' | 'UINTEGER' | 'NULL' | 'OBJGROUP' | 'NOTIFGROUP', nullable — Symbolic name of the MIB type (e.g. `COUNTER32`). Null if the type code is unknown.
  - `typeCode` integer — Numeric MIB type code as defined in `nxsnmp.h` (MIB_TYPE_*).
  - `status` 'MANDATORY' | 'OPTIONAL' | 'OBSOLETE' | 'DEPRECATED' | 'CURRENT', nullable — Symbolic name of the MIB status. Null if the status code is unknown.
  - `statusCode` integer — Numeric MIB status code as defined in `nxsnmp.h` (MIB_STATUS_*).
  - `access` 'READONLY' | 'READWRITE' | 'WRITEONLY' | 'NOACCESS' | 'NOTIFY' | 'CREATE', nullable — Symbolic name of the MIB access mode. Null if the access code is unknown.
  - `accessCode` integer — Numeric MIB access code as defined in `nxsnmp.h` (MIB_ACCESS_*).
  - `description` string, nullable — DESCRIPTION clause from the MIB module.
  - `textualConvention` string, nullable — Name of the textual convention applied to this object, if any.
  - `displayHint` string, nullable — DISPLAY-HINT clause for formatting raw values.
  - `enumValues` string, nullable — Comma-separated list of named enumeration values, if defined.
  - `index` string, nullable — INDEX clause for SMIv2 table entries.
  - `parent` string, nullable — Full dotted OID of the parent node. Null for the synthetic root.
  - `children` MibNodeChild[] — Immediate child nodes (one level deep).
    - `subId` integer — Sub-identifier under the parent (last component of the child's OID).
    - `oid` string — Full dotted OID of the child node.
    - `name` string, nullable — Symbolic name of the child node, if defined.
    - `hasChildren` boolean — True if this child has further descendants.

## Other responses

- `400` — Invalid OID
- `401` — Unauthorized
- `404` — No MIB object found with the given OID
- `503` — MIB tree is not loaded

---

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