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

# GET /nodes

`GET /nodes`

Get information about nodes

## Query parameters

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

## Response `200`

successful operation

- Node[]
  - `infrastructure` Infrastructure
    - `description` string — Text description of the infrastructure.
    - `layout` InfrastructurePart[] — The list of parts composing the infrastructure.
      - `network` NetworkEquipment[] — The list of network equipments of the infrastructure in this rack.
        - `infrastructure` Infrastructure — recursive
        - `name` string — The names of the network equipments in this set.
        - `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` Node[] — The list of nodes of the infrastructure in this rack.
      - `rack` string — The names of the racks in this set.
      - `storage` StorageEquipment[] — The list of storage equipments of the infrastructure in this rack.
        - `infrastructure` Infrastructure — recursive
        - `name` string — The names of the storage equipments in this set.
        - `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.
  - `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.

## Changes

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

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