--- title: "GET /v0.7.0/racks" method: GET path: "/v0.7.0/racks" --- # GET /v0.7.0/racks `GET /v0.7.0/racks` Get information about racks ## Query parameters - `name` string - `list` unknown - `fold` unknown - `with_objects_types` unknown - `format` 'yaml' | 'json' ## Response `200` successful operation - RacksDBRack[] - `datacenter` 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. - `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. - `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. - `misc` RacksDBMiscEquipment[] — The list of miscellaneous equipments of the infrastructure in this rack. - `infrastructure` RacksDBInfrastructure — recursive - `name` string — The names of the miscellaneous equipments 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 miscellaneous equipment in this set. - `tags` string[] — The list of tags associated to these miscellaneous equipments. - `type` string — Unique identifier of the miscellaneous equipment type. - `network` RacksDBNetworkEquipment[] — The list of network equipments of the infrastructure in this rack. - `infrastructure` RacksDBInfrastructure — recursive - `name` string — The names of the network equipments 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 network equipment in this set. - `tags` string[] — The list of tags associated to these network equipments. - `type` string — Unique identifier of the network equipment type. - `nodes` RacksDBNode[] — The list of nodes of the infrastructure in this rack. - `rack` string — The names of the racks in this set. - `storage` RacksDBStorageEquipment[] — The list of storage equipments of the infrastructure in this rack. - `infrastructure` RacksDBInfrastructure — recursive - `name` string — The names of the storage equipments 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 storage equipment in this set. - `tags` string[] — The list of tags associated to these storage equipments. - `type` string — Unique identifier of storage equipment type. - `tags` string[] — The list of tags associated to the equipments of the infrastructure in this rack. - `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 - `datacenter` 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. - `tags` string[] — The list of tags associated to this datacenter. - `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. - `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` RacksDBRacksRow - `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. - `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. - `tags` string[] — The list of tags associated to the rack. - `type` string — Unique identifier of the rack type. ## 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/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/7f32d9c7db2a/schema)