---
title: "Get room placement of a rack"
method: GET
path: "/v1/objects/{object-id}/room-placement"
tags: ["Objects"]
---

# Get room placement of a rack

`GET /v1/objects/{object-id}/room-placement`

Return the room placement of a rack (the same shape accepted by the matching PATCH).

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

## Path parameters

- `object-id` integer, required

## Response `200`

Room placement.

- RackRoomPlacement — Placement of a rack on the floor plan of its room. Returned by GET /v1/objects/{id}/room-placement and embedded as `ObjectDetails.roomPlacement`; accepted by PATCH /v1/objects/{id}/room-placement with merge-patch semantics. Values are only meaningful while the rack has a Room parent and `placed` is true.
  - `placed` boolean — True if the rack has been positioned on the floor plan. Cleared by the server when the rack is unbound from its room.
  - `x` integer — X coordinate of rack footprint reference corner in room coordinates, millimetres.
  - `y` integer — Y coordinate of rack footprint reference corner in room coordinates, millimetres.
  - `rotation` integer — Rotation in degrees (front direction); normalised by the server to the range 0..359.

## 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-21** `2827204d68d9` — 1 info
  - endpoint added

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