# Kubernetes Versions

## List NKS Kubernetes Versions

**get** `/v1/nks/kubernetes_versions`

List all supported Kubernetes versions for NKS clusters

### Query Parameters

- `cursor: optional string`

  Pagination cursor returned by a previous request

- `limit: optional number`

  Maximum number of items to return

### Returns

- `items: array of KubernetesVersion`

  - `created_at: string`

    When the Kubernetes version was created.

  - `display_name: string`

    Display name of the Kubernetes version.

  - `name: string`

    Name of the Kubernetes version.

- `pagination: Pagination`

  Pagination response details.

  - `next_cursor: string`

  - `previous_cursor: string`

  - `total_count: number`

### Example

```http
curl https://api.nirvanalabs.io/v1/nks/kubernetes_versions \
    -H "Authorization: Bearer $NIRVANA_LABS_API_KEY"
```

#### Response

```json
{
  "items": [
    {
      "created_at": "2025-01-01T00:00:00Z",
      "display_name": "Kubernetes v1.34.4",
      "name": "v1.34.4"
    }
  ],
  "pagination": {
    "next_cursor": "RhwniMT4B74siYZcPF8TnCdGI1l9rpPvg",
    "previous_cursor": "ARhwnmi1hA7wEbHbMjdYQlOB_ZusP4fYvw",
    "total_count": 125
  }
}
```

## Domain Types

### Kubernetes Version

- `KubernetesVersion object { created_at, display_name, name }`

  NKS Kubernetes version details.

  - `created_at: string`

    When the Kubernetes version was created.

  - `display_name: string`

    Display name of the Kubernetes version.

  - `name: string`

    Name of the Kubernetes version.