---
title: "GET /v0.7.0/datacenters"
method: GET
path: "/v0.7.0/datacenters"
---

# GET /v0.7.0/datacenters

`GET /v0.7.0/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

- RacksDBDatacenter[]
  - `location` RacksDBDatacenterLocation
    - `latitude` number — GPS latitude of the datacenter.
    - `longitude` number — GPS longitude of the datacenter.
  - `name` string — Unique name of the datacenter.
  - `rooms` RacksDBDatacenterRoom[] — List of rooms in this datacenter.
    - `datacenter` RacksDBDatacenter — recursive
    - `dimensions` RacksDBDatacenterRoomDimensions
      - `depth` integer — Depth of datacenter room.
      - `width` integer — Width of datacenter room.
    - `name` string — Unique name of the room in this datacenter.
    - `rows` RacksDBRacksRow[] — List of racks rows on this room.
      - `name` string — Unique name of the racks row.
      - `nbracks` integer — Number of racks in the row.
      - `position` RacksDBRacksRowPosition — 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` RacksDBRack[] — The list of (empty) racks in the row.
        - `datacenter` RacksDBDatacenter — recursive
        - `fillrate` number — Rack filling rate.
        - `name` string — The names of the racks in this set.
        - `nodes` RacksDBNode[] — List of nodes in the rack.
          - `infrastructure` RacksDBInfrastructure
            - `description` string — Text description of the infrastructure.
            - `layout` RacksDBInfrastructurePart[] — The list of parts composing the infrastructure.
              - …
            - `name` string — The name of the infrastructure.
            - `tags` string[] — List of tags associated to the infrastructure.
          - `name` string — The names of the nodes in this set.
          - `position` RacksDBEquipmentPosition — Equipment position in the rack.
            - `height` integer — Rack slot where the equipment is located.
            - `width` integer — Equipment position in rack width.
          - `rack` string — The names of the racks in this set.
          - `slot` integer — The slot in the rack used by the first node in this set.
          - `tags` string[] — The list of tags associated to these nodes.
          - `type` string — Unique identifier of node type.
        - `room` RacksDBDatacenterRoom — recursive
        - `row` RacksDBRacksRow — recursive
        - `slot` integer — The first slot used by this set of racks.
        - `tags` string[] — The list of tags associated to the rack.
        - `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

- **2026-07-17** `7f32d9c7db2a` — 1 info
  - endpoint added
- **2023-10-18** `6f32ac8a6116` — 1 breaking
  - api path removed without deprecation

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