---
title: "Get a node"
method: GET
path: "/v1/kubernetes/clusters/{id}/nodes/{nodeId}"
tags: ["Kubernetes"]
---

# Get a node

`GET /v1/kubernetes/clusters/{id}/nodes/{nodeId}`

The node, with its registration and Ready state, public IP and GPUs. Needs clusters:read on an API key, or any organization role on a session.

## Path parameters

- `id` string, required
- `nodeId` string, required

## Response `200`

The node

- KubernetesNode — One worker node, a whole host in the cluster: what the control plane owns about it. Its labels, annotations and conditions are read in the cluster with kubectl.
  - `gpu` KubernetesNodeGpu
    - `count` integer, required — GPUs on the node.
    - `cudaRuntimeVersion` string
    - `driverVersion` string — NVIDIA driver version, for example 580.159.04.
    - `memory` string — Memory per GPU, for example 97887MiB.
    - `model` string
  - `id` string, required
  - `joinedAt` string
  - `kubernetesStatus` 'Ready' | 'NotReady' | 'Unknown' — The node's Ready condition, set once it joins.
  - `name` string — The node's name in the cluster, set once it joins; kubectl shows the node under this name.
  - `nodePoolId` string, required
  - `publicIp` string, ipv4 — The host's public IPv4 address, which the node advertises.
  - `registeredAt` string
  - `registrationStatus` 'registered' | 'joined', required — registered: the host is claimed and booting, not yet in the cluster. joined: the node joined the cluster.

## Other responses

- `401` — Missing or invalid API key
- `403` — The caller is authenticated but may not do this. The caller's role or the API key's scope does not allow it, or the request targets another organization (FORBIDDEN, or NOT_A_MEMBER for a session), or the organization is suspended pending review (ORG_SUSPENDED) or has been deleted (ORG_DISABLED). A new API key or a wider scope clears neither of the last two; see [Account and balance refusals](https://docs.openrelay.inc/docs/errors#account-and-balance-refusals).
- `404` — Resource not found

## Changes

- **2026-10-03** `bcf63adad2c3` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/openrelay/apis/openrelay-api/changes/v1/kubernetes/clusters/:id/nodes/:nodeId/get.md)

---

[API](https://skmtc.dev/openrelay/apis/openrelay-api.md) · [All operations](https://skmtc.dev/openrelay/apis/openrelay-api/llms.txt) · [OpenAPI document](https://skmtc.dev/openrelay/apis/openrelay-api/revisions/bcf63adad2c3?raw)