---
title: "Get cluster nodes"
method: GET
path: "/nodes"
tags: ["Cluster"]
---

# Get cluster nodes

`GET /nodes`

Returns status information for all nodes in the cluster.

## Response `200`

Node list

- DbconsoleNodesResponse
  - `nodes` DbconsoleNodeInfo[] — Nodes contains status information for all nodes in the cluster.
    - `address` string — Address is the RPC address of the node.
    - `build_tag` string — BuildTag is the build version tag of the node.
    - `liveness_status` string — LivenessStatus is the liveness status of the node.
    - `locality` object — Locality contains the locality information for the node.
    - `node_id` integer — NodeID is the unique identifier for the node.
    - `num_cpus` integer — NumCpus is the number of logical CPUs.
    - `sql_address` string — SQLAddress is the SQL address of the node.
    - `started_at` integer — StartedAt is the unix timestamp when the node was started.
    - `total_system_memory` integer — TotalSystemMemory is the total RAM available to the system in bytes.
    - `updated_at` integer — UpdatedAt is the unix timestamp when the node status was last updated.

## Other responses

- `500` — Internal error

---

[API](https://skmtc.dev/cockroachdb/apis/db-console-api.md) · [All operations](https://skmtc.dev/cockroachdb/apis/db-console-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/cockroachdb/db-console-api/revisions/c0b4eb6b5fc5/schema)