---
title: "List a cluster's node pools"
method: GET
path: "/v1/kubernetes/clusters/{id}/node-pools"
tags: ["Kubernetes"]
---

# List a cluster's node pools

`GET /v1/kubernetes/clusters/{id}/node-pools`

Needs clusters:read on an API key, or any organization role on a session.

## Path parameters

- `id` string, required

## Query parameters

- `limit` integer
- `cursor` string

## Response `200`

Page of node pools

- KubernetesNodePoolPage
  - `items` KubernetesNodePool[], required
    - `clusterId` string, required
    - `count` integer, required — Nodes the pool holds once it converges.
    - `createdAt` string, required
    - `id` string, required
    - `name` string, required
    - `readyCount` integer, required — Nodes that joined the cluster and are Ready.
    - `sku` KubernetesNodePoolSku, required — What every node in a pool is: exactly one of gpuModelId or cpuSku. Nodes are whole hosts, so a GPU node is a host of that model with every GPU passed through to it, and a CPU node is a whole CPU host. A cluster mixes SKUs through several pools.
      - `cpuSku` string — Whole-host CPU SKU.
      - `gpuModelId` string — GPU model, one of listGpuModels.
    - `status` 'creating' | 'ready' | 'scaling' | 'deleting' | 'failed', required
  - `nextCursor` string — Opaque; pass back to continue. Absent means no more pages.

## Other responses

- `400` — The request is invalid
- `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/node-pools/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)