---
title: "GET /racks"
method: GET
path: "/racks"
---

# GET /racks

`GET /racks`

Get information about racks

## Query parameters

- `name` string
- `list` unknown
- `fold` unknown
- `with_objects_types` unknown
- `format` 'yaml' | 'json'

## Response `200`

successful operation

- DatacenterRoomRack[]
  - `datacenter` Datacenter
    - `name` string — Unique name of the datacenter.
    - `rooms` DatacenterRoom[] — List of rooms in this datacenter.
      - `datacenter` Datacenter — recursive
      - `dimensions` DatacenterRoomDimensions
        - `depth` integer — Depth of datacenter room.
        - `width` integer — Width of datacenter room.
      - `name` string — Unique name of the room in this datacenter.
      - `rows` DatacenterRoomRow[] — List of racks rows on this room.
        - `name` string — Unique name of the racks row.
        - `position` DatacenterRoomPosition — NOTE: Please refer to xref:positioning-racks.adoc[racks positioning how-to] for more details.
          - `depth` integer — The position of the top-left corner of the racks row in the depth axis of the room.
          - `rotation` integer — The rotation angle of the racks row clockwise compared to the width axis of the room (ie. an horizontal line).
          - `width` integer — The position of the top-left corner of the racks row in the width axis of the room.
        - `racks` DatacenterRoomRack[] — The list of (empty) racks in the room.
        - `reversed` boolean — Boolean to control the side of the racks doors in the racks row. When reversed is true, the doors are on the top.
    - `tags` string[] — The list of tags associated to this datacenter.
  - `name` string — The names of the racks in this set.
  - `room` DatacenterRoom
    - `datacenter` Datacenter
      - `name` string — Unique name of the datacenter.
      - `rooms` DatacenterRoom[] — List of rooms in this datacenter.
      - `tags` string[] — The list of tags associated to this datacenter.
    - `dimensions` DatacenterRoomDimensions
      - `depth` integer — Depth of datacenter room.
      - `width` integer — Width of datacenter room.
    - `name` string — Unique name of the room in this datacenter.
    - `rows` DatacenterRoomRow[] — List of racks rows on this room.
      - `name` string — Unique name of the racks row.
      - `position` DatacenterRoomPosition — NOTE: Please refer to xref:positioning-racks.adoc[racks positioning how-to] for more details.
        - `depth` integer — The position of the top-left corner of the racks row in the depth axis of the room.
        - `rotation` integer — The rotation angle of the racks row clockwise compared to the width axis of the room (ie. an horizontal line).
        - `width` integer — The position of the top-left corner of the racks row in the width axis of the room.
      - `racks` DatacenterRoomRack[] — The list of (empty) racks in the room.
      - `reversed` boolean — Boolean to control the side of the racks doors in the racks row. When reversed is true, the doors are on the top.
  - `row` DatacenterRoomRow
    - `name` string — Unique name of the racks row.
    - `position` DatacenterRoomPosition — NOTE: Please refer to xref:positioning-racks.adoc[racks positioning how-to] for more details.
      - `depth` integer — The position of the top-left corner of the racks row in the depth axis of the room.
      - `rotation` integer — The rotation angle of the racks row clockwise compared to the width axis of the room (ie. an horizontal line).
      - `width` integer — The position of the top-left corner of the racks row in the width axis of the room.
    - `racks` DatacenterRoomRack[] — The list of (empty) racks in the room.
    - `reversed` boolean — Boolean to control the side of the racks doors in the racks row. When reversed is true, the doors are on the top.
  - `slot` integer — The first slot used by this set of racks.
  - `type` string — Unique identifier of the rack type.

## Changes

- **2023-10-18** `6f32ac8a6116` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/rackslab/apis/racksdb-rest-api/changes/racks/get.md)

---

[API](https://skmtc.dev/rackslab/apis/racksdb-rest-api.md) · [All operations](https://skmtc.dev/rackslab/apis/racksdb-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/rackslab/racksdb-rest-api/revisions/6f32ac8a6116/schema)