---
title: "Retrieve a Rack"
method: GET
path: "/v2/org/{org}/nico/rack/{id}"
tags: ["Rack"]
---

# Retrieve a Rack

`GET /v2/org/{org}/nico/rack/{id}`

Get a Rack by ID.

Org must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` suffix.

## Query parameters

- `siteId` string, uuid, required
- `includeComponents` boolean

## Response `200`

OK

- Rack — Rack represents a physical rack in the datacenter
  - `id` string, uuid — Unique identifier of the Rack
  - `name` string — Name of the Rack
  - `manufacturer` string — Manufacturer of the Rack
  - `model` string — Model of the Rack
  - `serialNumber` string — Serial number of the Rack
  - `description` string — Description of the Rack
  - `nvLinkDomainIds` string[], required — IDs of the NVLink Domains containing this Rack. Empty when the Rack is not assigned to an NVLink Domain.
  - `location` RackLocation — Physical location of a Rack
    - `region` string — Region where the rack is located
    - `datacenter` string — Datacenter where the rack is located
    - `room` string — Room within the datacenter
    - `position` string — Position of the rack within the room
  - `components` RackComponent[] — Components within the Rack. Only returned when includeComponents is true.
    - `id` string, uuid — Unique identifier of the component
    - `componentId` string — ID of the component
    - `rackId` string, uuid — ID of the rack this component belongs to
    - `type` string — Type of the component (e.g. Compute, NVSwitch, PowerShelf)
    - `name` string — Name of the component
    - `serialNumber` string — Serial number of the component
    - `manufacturer` string — Manufacturer of the component
    - `model` string — Model of the component
    - `description` string — Description of the component (JSON string)
    - `firmwareVersion` string — Firmware version of the component
    - `slotId` integer — Slot ID of the component within the rack
    - `trayIdx` integer — Tray index of the component
    - `hostId` integer — Host ID of the component
    - `bmcs` BMCInfo[] — BMC (Baseboard Management Controller) entries for the component
      - `type` string — BMC type (e.g. BmcTypeHost, BmcTypeDpu)
      - `macAddress` string — MAC address of the BMC
      - `ipAddress` string — IP address of the BMC
    - `powerState` string — Current power state of the component
    - `operationStatus` 'Unknown' | 'Initializing' | 'Ready' | 'InUse' | 'Error' | 'Deleting' — Flow-derived operability phase of the component
    - `leakStatus` 'Unknown' | 'NoLeak' | 'Leaking' — Whether the component is considered leaking coolant
  - `taskStats` TaskStats, required — Counts of non-terminal tasks currently associated with a rack or tray. Rack stats include component-scoped tasks on the rack; tray stats include only tasks that explicitly target the tray.
    - `pendingTaskCount` integer, required — Number of associated tasks in Waiting or Pending state.
    - `activeTaskCount` integer, required — Number of associated tasks in Running state.

## Other responses

- `403` — Error response when user is not authorized to call an endpoint or retrieve/modify objects
- `404` — Error response when requested object is not found
- `504` — The Site did not return a result within the request budget allocated to Site communication within the request cycle. This can occur if the Site Controller is down or under heavy request load. Operations are in general safe to retry. In rare cases, operations that create or update resources may succeed even if timeout is returned.

## Changes

- **2026-08-26** `01e93520819d` — 1 info
  - added the required property `taskStats` to the response with the `200` status
- **2026-08-21** `77c18e801096` — 1 info
  - added the required property `nvLinkDomainIds` to the response with the `200` status
- **2026-08-14** `441cfc1afc1c` — 1 info
  - added the non-success response with the status `504`
- **2026-06-12** `268117a96421` — 2 info
  - added the optional property `components/items/leakStatus` to the response with the `200` status
  - added the optional property `components/items/operationStatus` to the response with the `200` status

[Change history](https://skmtc.dev/nvidia/apis/nvidia-infra-controller-rest-api/changes/v2/org/:org/nico/rack/:id/get.md)

---

[API](https://skmtc.dev/nvidia/apis/nvidia-infra-controller-rest-api.md) · [All operations](https://skmtc.dev/nvidia/apis/nvidia-infra-controller-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nvidia/nvidia-infra-controller-rest-api/revisions/2096eb1db2c1/schema)