---
title: "List server configuration variables"
method: GET
path: "/v1/server-config"
tags: ["Server"]
---

# List server configuration variables

`GET /v1/server-config`

Retrieve all visible server configuration variables. Requires SERVER_CONFIG access right. Hidden variables (is_visible = 0) are never returned.

## Response `200`

Configuration variables retrieved successfully

- ServerConfigVariable[]
  - `name` string — Variable name (up to 63 characters)
  - `value` string — Current value
  - `defaultValue` string — Default value, empty if not defined
  - `dataType` 'STRING' | 'BOOLEAN' | 'INTEGER' | 'CHOICE' | 'COLOR' | 'PASSWORD' — Type of the value. BOOLEAN values are stored as "0" and "1", COLOR values as CSS color strings, and CHOICE values must be one of possibleValues.
  - `description` string — Human readable description, empty if not defined
  - `units` string — Units of the value (for INTEGER variables), empty if not defined
  - `needServerRestart` boolean — True if server restart is required for a change to take effect
  - `possibleValues` ServerConfigPossibleValue[] — Allowed values, populated for CHOICE variables only
    - `value` string — Value as stored in the variable
    - `description` string — Human readable description of the value

## Other responses

- `401` — Unauthorized
- `403` — User does not have SERVER_CONFIG access right
- `500` — Database failure

## Changes

- **2026-09-15** `6eac6acac8bf` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/netxms/apis/netxms-api/changes/v1/server-config/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.dev/netxms/apis/netxms-api/revisions/6eac6acac8bf?raw)