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

# Get power domain configuration

`GET /v1/objects/{object-id}/power-domain`

Return the power domain's settings (the same shape accepted by the matching PATCH).

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

## Path parameters

- `object-id` integer, required

## Response `200`

Power domain configuration.

- PowerDomainConfig — Power domain property group. Returned by GET /v1/objects/{id}/power-domain and embedded as `ObjectDetails.powerDomain`; accepted by PATCH /v1/objects/{id}/power-domain with merge-patch semantics (omitted fields are left unchanged).
  - `domainType` 'GRID_ENTRY' | 'GENERATOR' | 'UPS' | 'PDU' | 'BUSWAY' | 'OTHER' — Role of the power domain in the electrical distribution tree.
  - `feedTag` string, nullable — Free feed label, conventionally `A` or `B`. May be empty for grid entry domains.
  - `ratedPower` integer — Nameplate power in watts; 0 means undeclared.

## 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

## Changes

- **2026-09-06** `c4fbee63f843` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/netxms/apis/netxms-api/changes/v1/objects/:object-id/power-domain/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/a81265c49fa9?raw)