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

# Retrieve a Tray

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

Get a Tray by ID.

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

## Query parameters

- `siteId` string, uuid, required

## Response `200`

OK

- Tray — Tray represents a component within a rack (e.g. compute node, NVSwitch, power shelf)
  - `id` string, uuid — Unique identifier of the Tray
  - `componentId` string — ID of the component
  - `type` 'Compute' | 'NVSwitch' | 'PowerShelf' — Type of the tray
  - `name` string — Name of the tray
  - `manufacturer` string — Manufacturer of the tray
  - `model` string — Model of the tray
  - `serialNumber` string — Serial number of the tray
  - `description` string — Description of the tray
  - `firmwareVersion` string — Firmware version of the tray
  - `powerState` string — Current power state of the tray
  - `operationStatus` 'Unknown' | 'Initializing' | 'Ready' | 'InUse' | 'Error' | 'Deleting' — Flow-derived operability phase of the tray
  - `leakStatus` 'Unknown' | 'NoLeak' | 'Leaking' — Whether the tray is considered leaking coolant
  - `position` TrayPosition — Position of a tray within a rack
    - `slotId` integer — Slot number of the tray in the rack
    - `trayIdx` integer — Index of the tray within its slot
    - `hostId` integer — Host ID associated with the tray
  - `bmcs` BMCInfo[] — BMC (Baseboard Management Controller) entries for the tray
    - `type` string — BMC type (e.g. BmcTypeHost, BmcTypeDpu)
    - `macAddress` string — MAC address of the BMC
    - `ipAddress` string — IP address of the BMC
  - `rackId` string, uuid — ID of the rack this tray belongs to
  - `nvLinkDomainId` string, uuid, nullable, required — ID of the NVLink Domain containing this Tray's Rack. Null when the Rack is not assigned to an NVLink Domain.
  - `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 `nvLinkDomainId` to the response with the `200` status
- **2026-08-20** `652b7687aa81` — 3 warning, 3 info
  - added the new `Compute` enum value to the `type` response property for the response status `200`
  - added the new `NVSwitch` enum value to the `type` response property for the response status `200`
  - added the new `PowerShelf` enum value to the `type` response property for the response status `200`
  - removed the `compute` enum value from the `type` response property for the response status `200`
  - …2 more
- **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 `leakStatus` to the response with the `200` status
  - added the optional property `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/tray/: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)