---
title: "Get chassis layout"
method: GET
path: "/v1/objects/{object-id}/chassis-layout"
tags: ["Objects"]
---

# Get chassis layout

`GET /v1/objects/{object-id}/chassis-layout`

Retrieve the complete layout of a chassis in a single call: chassis metadata and all placed component objects (nodes) with their placement geometry. Components are filtered by the requesting user's read access and only those carrying a placement configuration are returned.

## Path parameters

- `object-id` integer, required

## Response `200`

Chassis layout retrieved successfully

- object
  - `chassisId` integer — Chassis object ID
  - `name` string — Chassis name
  - `controllerId` integer — ID of the controller node managing the chassis
  - `status` integer — Chassis object status
  - `objects` object[] — Placed component objects (nodes) with chassis placement
    - `id` integer — Object ID
    - `objectClass` integer — Object class code
    - `name` string — Object name
    - `status` integer — Object status
    - `placement` ChassisPlacement — Placement geometry of an object within a chassis. Returned both in the chassis layout and as the `chassisPlacementConfig` property of a node.
      - `image` string, uuid — GUID of the image representing the component
      - `height` integer — Component height
      - `heightUnits` integer — Units for height (0 = rack units, 1 = millimeters)
      - `width` integer — Component width
      - `widthUnits` integer — Units for width (0 = horizontal pitch, 1 = millimeters)
      - `positionHeight` integer — Vertical position of the top-left corner
      - `positionHeightUnits` integer — Units for vertical position (0 = rack units, 1 = millimeters)
      - `positionWidth` integer — Horizontal position of the top-left corner
      - `positionWidthUnits` integer — Units for horizontal position (0 = horizontal pitch, 1 = millimeters)
      - `orientation` integer — Orientation (1=front, 2=rear)

## Other responses

- `400` — Object ID is invalid or object is not a chassis
- `401` — Unauthorized
- `403` — User does not have read access to given 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/ee1f54ee3abd/schema)