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

# GET /datacenters

`GET /datacenters`

Get information about datacenters

## Query parameters

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

## Response `200`

successful operation

- 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.
        - `datacenter` Datacenter — recursive
        - `name` string — The names of the racks in this set.
        - `room` DatacenterRoom — recursive
        - `row` DatacenterRoomRow — recursive
        - `slot` integer — The first slot used by this set of racks.
        - `type` string — Unique identifier of the rack type.
      - `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.

## Changes

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

[Change history](https://skmtc.dev/rackslab/apis/racksdb-rest-api/changes/datacenters/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)