---
title: "Lists all Kubernetes clusters in the project and returns their details."
method: GET
path: "/projects/{project_id}/kubernetes/clusters"
tags: ["Kubernetes Clusters"]
---

# Lists all Kubernetes clusters in the project and returns their details.

`GET /projects/{project_id}/kubernetes/clusters`

## Path parameters

- `project_id` string, required

## Query parameters

- `cluster_id` string
- `cluster_name` string
- `cluster_search_names` string[]
- `locations` string[]
- `states` string[]
- `versions` string[]
- `sort` string
- `show_inactive` boolean
- `next_token` string
- `prev_token` string

## Response `200`

- ListKubernetesClustersResponse
  - `items` KubernetesCluster[], required
    - `add_ons` string[], required — Add-ons associated with the cluster.
    - `apiserver_extra_args` object — Extra arguments passed to the kube-apiserver control plane component.
    - `auth_config` KubernetesClusterAuthConfig — This configures how users authenticate to the Kubernetes API server. example: {"oidc": {"issuer_url": "https://oauth2.example.com", "client_id": "kubernetes"}}
      - `oidc` OIDCAuthConfig — This allows the Kubernetes API server to authenticate users via an external OIDC provider.
        - `ca_cert` string — PEM-encoded certificate authority certificate used to validate the OIDC server's certificate.
        - `client_id` string — Client ID for the OpenID Connect client.
        - `groups_claim` string — Claim used to identify the user's groups.
        - `issuer_url` string — URL of the OpenID Connect issuer.
        - `username_claim` string — Claim used to identify the user. Defaults to 'sub'.
        - `username_prefix` string — Prefix added before the username to avoid name conflicts.
    - `cluster_cidr` string — Range of IP addresses allocated to pods scheduled on worker nodes, in CIDR notation.
    - `configuration` 'ha', required — Configuration setting of the Kubernetes cluster.
    - `controller_manager_extra_args` object — Extra arguments passed to the kube-controller-manager control plane component.
    - `created_at` string, required — Creation timestamp of the cluster, in RFC3339 format.
    - `dns_name` string, required — DNS name of the cluster.
    - `id` string, required — ID of the Kubernetes cluster.
    - `kubelogin_args` object, required — Arguments for the kubectl oidc-login plugin.
    - `location` string, required — Location of the Kubernetes cluster.
    - `name` string, required — Name of the Kubernetes cluster.
    - `node_cidr_mask_size` integer — Mask size for the cluster CIDR.
    - `node_pools` string[], required — IDs of the node pools within the Kubernetes cluster.
    - `private` boolean — Whether the cluster is private (without a public IP).
    - `project_id` string, required — ID of the project that owns the Kubernetes cluster.
    - `scheduler_extra_args` object — Extra arguments passed to the kube-scheduler control plane component.
    - `service_cluster_ip_range` string — Range of IP addresses allocated to Kubernetes services, in CIDR notation.
    - `state` string, required — Current state of the cluster.
    - `subnet_id` string, required — ID of the subnet the Kubernetes cluster belongs to.
    - `updated_at` string, required — Last update timestamp of the cluster, in RFC3339 format.
    - `version` string, required — Version of the Crusoe Kubernetes image the cluster runs.

## Other responses

- `401` — Error Authentication Failed
- `500` — Error Internal Server

---

[API](https://skmtc.net/crusoecloud/apis/crusoe-cloud-api-gateway.md) · [All operations](https://skmtc.net/crusoecloud/apis/crusoe-cloud-api-gateway/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/crusoecloud/crusoe-cloud-api-gateway/versions/a3fd2dedc72b/schema)