---
title: "Get node polling configuration"
method: GET
path: "/v1/objects/{object-id}/polling"
tags: ["Objects"]
---

# Get node polling configuration

`GET /v1/objects/{object-id}/polling`

Return the node's polling settings (the same shape accepted by the matching PATCH).

This property group applies to Node objects only; requesting it for any other object
class returns 400.

## Path parameters

- `object-id` integer, required

## Response `200`

Polling configuration.

- PollingConfig — Polling property group for a node. Returned by GET /v1/objects/{id}/polling and embedded as `ObjectDetails.polling`; accepted by PATCH /v1/objects/{id}/polling with merge-patch semantics (omitted fields are left unchanged). Within the `flags` object only the named booleans that are present are modified; the rest are preserved.
  - `pollerNode` integer — ID of the node used for polling, or 0 to poll from the server. Must reference a node object.
  - `requiredPollCount` integer — Number of consecutive polls required before a status change is registered.
  - `expectedCapabilities` integer — Expected capabilities bitmask.
  - `useIfXTable` integer — Whether to use SNMP ifXTable for interface polling (0 = server default, 1 = enabled, 2 = disabled).
  - `flags` object — Poll-type and per-protocol disable flags. Only present keys are changed.
    - `disableAgent` boolean — Disable usage of NetXMS agent for all polls.
    - `disableSNMP` boolean — Disable usage of SNMP for all polls.
    - `disableICMP` boolean — Disable usage of ICMP pings for status polling.
    - `disableSSH` boolean — Disable SSH usage for all polls.
    - `disableVNC` boolean — Disable VNC detection.
    - `disableSMCLPProperties` boolean — Disable reading of SM-CLP available properties metadata.
    - `disableEtherNetIP` boolean — Disable usage of EtherNet/IP for all polls.
    - `disableModbus` boolean — Disable usage of Modbus for all polls.
    - `disable8021xStatusPoll` boolean — Disable 802.1x port state checking during status poll.
    - `disableRoutePoll` boolean — Disable routing table polling.
    - `disableTopologyPoll` boolean — Disable topology polling.
    - `disableDiscoveryPoll` boolean — Disable network discovery polling.
    - `disablePerfCount` boolean — Disable reading of Windows performance counters metadata.
    - `disableStatusPoll` boolean — Disable status polling.
    - `disableConfigurationPoll` boolean — Disable configuration polling.
    - `disableDataCollection` boolean — Disable data collection.

## Other responses

- `400` — Property group not applicable to object class.
- `401` — Unauthorized
- `403` — User does not have read access to the 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/versions/14d93e5115dd/schema)