---
title: "Returns details for a single Kubernetes cluster in the project."
method: GET
path: "/projects/{project_id}/kubernetes/clusters/{cluster_id}"
tags: ["Kubernetes Clusters"]
---

# Returns details for a single Kubernetes cluster in the project.

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

## Path parameters

- `project_id` string, required
- `cluster_id` string, required

## Response `200`

- KubernetesCluster
  - `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)