---
title: "List cluster nodes"
method: GET
path: "/api/v1/orgs/{orgId}/clusters/{id}/nodes"
tags: ["clusters"]
---

# List cluster nodes

`GET /api/v1/orgs/{orgId}/clusters/{id}/nodes`

List cluster nodes

## Path parameters

- `orgId` integer, required
- `id` integer, required

## Response `200`

Nodes listed

- ListNodesResponse
  - `metadata` ListNodesResponseMetadata
    - `selfLink` string
    - `resourceVersion` string
  - `items` NodeItem[]
    - `metadata` NodeItemMetadata
      - `name` string
      - `selfLink` string
      - `uid` string
      - `resourceVersion` string
      - `creationTimestamp` string
      - `labels` object
      - `annotations` object
    - `spec` NodeItemSpec
      - `podCIDR` string
      - `externalID` string
      - `providerID` string
    - `status` NodeItemStatus
      - `capacity` NodeItemStatusCapacity
        - `cpu` string
        - `memory` string
        - `pods` string
      - `allocatable` NodeItemStatusAllocatable
        - `cpu` string
        - `memory` string
        - `pods` string
      - `conditions` NodeItemStatusConditionsInner[]
        - `type` string
        - `status` string
        - `lastHeartbeatTime` string
        - `lastTransitionTime` string
        - `reason` string
        - `message` string
      - `addresses` NodeItemStatusAddressesInner[]
        - `type` string
        - `address` string
      - `daemonEndpoints` NodeItemStatusDaemonEndpoints
        - `kubeletEndpoint` NodeItemStatusDaemonEndpointsKubeletEndpoint
          - `Port` integer
      - `nodeInfo` NodeItemStatusNodeInfo
        - `machineID` string
        - `systemUUID` string
        - `bootID` string
        - `kernelVersion` string
        - `osImage` string
        - `containerRuntimeVersion` string
        - `kubeletVersion` string
        - `kubeProxyVersion` string
        - `operatingSystem` string
        - `architecture` string
      - `images` NodeItemStatusImagesInner[]
        - `name` string[]
        - `sizeBytes` integer

## Other responses

- `default` — Internal server error

## Changes

- **2026-07-17** `a2e35c430378` — 11 breaking
  - the `items/items/metadata` response's property type changed from no type to `object` for status `200`
  - the `items/items/spec` response's property type changed from no type to `object` for status `200`
  - the `items/items/status` response's property type changed from no type to `object` for status `200`
  - the `items/items/status/addresses/items/` response's property type changed from no type to `object` for status `200`
  - …7 more
- **2020-04-24** `5186ea64aa56` — 12 breaking
  - the `items/items/metadata` response's property type changed from `object` to no type for status `200`
  - the `items/items/spec` response's property type changed from `object` to no type for status `200`
  - the `items/items/status` response's property type changed from `object` to no type for status `200`
  - the `items/items/status/addresses/items/` response's property type changed from `object` to no type for status `200`
  - …8 more

[Change history](https://skmtc.dev/banzaicloud/apis/pipeline-api/changes/api/v1/orgs/:orgId/clusters/:id/nodes/get.md)

---

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