---
title: "Retrieve all Expected Racks"
method: GET
path: "/v2/org/{org}/nico/expected-rack"
tags: ["Expected Rack"]
---

# Retrieve all Expected Racks

`GET /v2/org/{org}/nico/expected-rack`

Retrieve all Expected Racks.

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

Alternatively, Tenant Admins with `TargetedInstanceCreation` capability can also retrieve Expected Racks if they have an account with the Site's Infrastructure Provider (siteId query parameter is required for Tenants).

## Query parameters

- `siteId` string, uuid
- `includeRelation` 'Site'
- `pageNumber` integer — One-indexed page number.
- `pageSize` integer
- `orderBy` 'RACK_ID_ASC' | 'RACK_ID_DESC' | 'RACK_PROFILE_ID_ASC' | 'RACK_PROFILE_ID_DESC' | 'CREATED_ASC' | 'CREATED_DESC' | 'UPDATED_ASC' | 'UPDATED_DESC'

## Response `200`

OK

- ExpectedRack[]
  - `id` string, uuid — Unique identifier (UUID) for the Expected Rack
  - `rackId` string — Operator-supplied identifier for the rack (string, not UUID). Unique within a Site.
  - `siteId` string, uuid — ID of the Site the Expected Rack belongs to
  - `rackProfileId` string — Identifier of the Rack Profile this rack conforms to
  - `name` string — Human-readable name of the Expected Rack
  - `description` string — Human-readable description of the Expected Rack
  - `labels` Labels
  - `created` string, date-time — ISO 8601 datetime when the Expected Rack was created
  - `updated` string, date-time — ISO 8601 datetime when the Expected Rack was last updated

## Other responses

- `400` — Error response when request data cannot be validated
- `403` — Error response when user is not authorized to call an endpoint or retrieve/modify objects

## Changes

- **2026-08-18** `c459c6587dee` — 1 warning
  - for the `query` request parameter `pageNumber`, the max was set to `21474836.00`

[Change history](https://skmtc.dev/nvidia/apis/nvidia-infra-controller-rest-api/changes/v2/org/:org/nico/expected-rack/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)