---
title: "Returns a list of known nodes"
method: GET
path: "/nodes"
---

# Returns a list of known nodes

`GET /nodes`

## Response `200`

A JSON array of nodes info and vdisks on them

- Node[]
  - `name` string, required
  - `address` string, required
  - `vdisks` VDisk[]
    - `id` integer, required
    - `replicas` Replica[]
      - `node` string
      - `disk` string, required
      - `path` string, required

## Other responses

- `403` — Permission denied

## Changes

> 11 revisions in range; 3 could not be searched.

- **2022-07-03** `fa4b74390467` — 1 breaking, 1 info
  - the `items/vdisks` response's property type/format changed from `string`/`` to `array`/`` for status `200`
  - added the non-success response with the status `403`

[Change history](https://skmtc.dev/qoollo/apis/bob-node-api/changes/nodes/get.md)

---

[API](https://skmtc.dev/qoollo/apis/bob-node-api.md) · [All operations](https://skmtc.dev/qoollo/apis/bob-node-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/qoollo/bob-node-api/revisions/73016e163ee1/schema)