---
title: "List all the nodes in a project identified by the project UUID"
method: GET
path: "/v4/{projectId}/nodes"
tags: ["Node"]
---

# List all the nodes in a project identified by the project UUID

`GET /v4/{projectId}/nodes`

## Path parameters

- `projectId` string, required

## Headers

- `X-Auth-Token` string, required

## Response `200`

OK

- NodeDetails[]
  - `name` string — Host name of the node
  - `uuid` string — UUID of the node
  - `primaryIp` string — IP address of the node
  - `nodePoolName` string — Name of the node pool, the node belongs to
  - `nodePoolUuid` string — UUID of the node pool, the node belongs to
  - `cloudProviderType` string — Type of cloud provider, such as local or aws used to create the cluster
  - `cloudProviderUuid` string — UUID of the cloud provider used to create the cluster
  - `cloudInstanceId` string — UUID of the cloud instance used to create the cluster
  - `clusterName` string — Name of the cluster the node belongs to
  - `clusterUuid` string — UUID of the cluster the node belongs to
  - `projectId` string — UUID of the project the node belongs to
  - `actualKubeRoleVersion` string — actual version of the kube role on the node
  - `clusterKubeRoleVersion` string — Kube version of the cluster the node belongs to
  - `isMaster` integer — 1 if this node is a master of a custer. 0 otherwise.
  - `api_responding` integer — 1 indicates the API server on this node is running. 0 otherwise. Applicable only if isMaster is 1
  - `status` string — Status of the node. States include “ok”, ”converging”, “failed”. These states indicate the current state of kubernetes setup on the host.
  - `masterless` integer — 1 indicates the node is a masterless node. 0 otherwise
  - `startKube` integer — 1 indicates kube to be installed on the node . 0 otherwise

## Other responses

- `403` — unauthorized to perform this operation

---

[API](https://skmtc.net/platform9/apis/cluster-blueprint-api.md) · [All operations](https://skmtc.net/platform9/apis/cluster-blueprint-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/platform9/cluster-blueprint-api/revisions/708ad90fe444/schema)