---
title: "List All Node Pools in a Kubernetes Clusters"
method: GET
path: "/v2/kubernetes/clusters/{cluster_id}/node_pools"
tags: ["DigitalOcean-public.v2-new_Kubernetes"]
---

# List All Node Pools in a Kubernetes Clusters

`GET /v2/kubernetes/clusters/{cluster_id}/node_pools`

To list all of the node pools in a Kubernetes clusters, send a GET request to
`/v2/kubernetes/clusters/$K8S_CLUSTER_ID/node_pools`.

## Path parameters

- `cluster_id` string, uuid, required

## Response `200`

The response will be a JSON object with a key called `node_pools`. This will
be set to an array of objects, each of which will contain the standard node
pool attributes.

- object
  - `node_pools` KubernetesNodePool[]
    - `size` string, required — The slug identifier for the type of Droplet used as workers in the node pool.
    - `id` string, uuid — A unique ID that can be used to identify and reference a specific node pool.
    - `name` string, required — A human-readable name for the node pool.
    - `count` integer, required — The number of Droplet instances in the node pool.
    - `tags` string[] — An array containing the tags applied to the node pool. All node pools are automatically tagged `k8s`, `k8s-worker`, and `k8s:$K8S_CLUSTER_ID`. <br><br>Requires `tag:read` scope.
    - `labels` object, nullable — An object of key/value mappings specifying labels to apply to all nodes in a pool. Labels will automatically be applied to all existing nodes and any subsequent nodes added to the pool. Note that when a label is removed, it is not deleted from the nodes in the pool.
    - `taints` KubernetesNodePoolTaint[] — An array of taints to apply to all nodes in a pool. Taints will automatically be applied to all existing nodes and any subsequent nodes added to the pool. When a taint is removed, it is deleted from all nodes in the pool.
      - `key` string — An arbitrary string. The `key` and `value` fields of the `taint` object form a key-value pair. For example, if the value of the `key` field is "special" and the value of the `value` field is "gpu", the key value pair would be `special=gpu`.
      - `value` string — An arbitrary string. The `key` and `value` fields of the `taint` object form a key-value pair. For example, if the value of the `key` field is "special" and the value of the `value` field is "gpu", the key value pair would be `special=gpu`.
      - `effect` 'NoSchedule' | 'PreferNoSchedule' | 'NoExecute' — How the node reacts to pods that it won't tolerate. Available effect values are `NoSchedule`, `PreferNoSchedule`, and `NoExecute`.
    - `auto_scale` boolean — A boolean value indicating whether auto-scaling is enabled for this node pool.
    - `min_nodes` integer — The minimum number of nodes that this node pool can be auto-scaled to. The value will be `0` if `auto_scale` is set to `false`.
    - `max_nodes` integer — The maximum number of nodes that this node pool can be auto-scaled to. The value will be `0` if `auto_scale` is set to `false`.
    - `nodes` Node[] — An object specifying the details of a specific worker node in a node pool.
      - `id` string, uuid — A unique ID that can be used to identify and reference the node.
      - `name` string — An automatically generated, human-readable name for the node.
      - `status` object — An object containing a `state` attribute whose value is set to a string indicating the current status of the node.
        - `state` 'provisioning' | 'running' | 'draining' | 'deleting' — A string indicating the current status of the node.
      - `droplet_id` string — The ID of the Droplet used for the worker node.
      - `created_at` string, date-time — A time value given in ISO8601 combined date and time format that represents when the node was created.
      - `updated_at` string, date-time — A time value given in ISO8601 combined date and time format that represents when the node was last updated.

## Other responses

- `401` — Authentication failed due to invalid credentials.
- `404` — The resource was not found.
- `429` — The API rate limit has been exceeded.
- `500` — There was a server error.
- `default` — There was an unexpected error.

---

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