---
title: "List Clusters"
method: GET
path: "/api/v1/clusters"
tags: ["clusters"]
---

# List Clusters

`GET /api/v1/clusters`

## Request

- Base URL: `https://api.mengi.cloud` (the document declares no server; this is the origin it was published from)
- URL: `https://api.mengi.cloud/api/v1/clusters`
- Auth: none declared

List all clusters for the current user (excludes management and host clusters).

For shared tier clusters (vClusters), fetches real-time status from ArgoCD
to ensure the UI always reflects the actual cluster state.

## Response `200`

Successful Response

- ClusterListResponse
  - `clusters` ClusterResponse[], required
    - `id` string, uuid, required
    - `name` string, required
    - `provider` string, required
    - `region` string, required
    - `tier` 'shared' | 'dedicated' | 'production', required
    - `status` 'pending' | 'provisioning' | 'importing' | 'running' | 'upgrading' | 'error' | 'deleting', required
    - `organization_id` string, uuid, nullable
    - `kubernetes_version` string, nullable
    - `server_type` string, nullable
    - `argocd_url` string, nullable
    - `git_repo_url` string, nullable
    - `error_message` string, nullable
    - `status_message` string, nullable
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `provisioning_started_at` string, date-time, nullable
    - `provisioning_completed_at` string, date-time, nullable
    - `autoscaling_enabled` boolean
    - `min_nodes` integer, nullable
    - `max_nodes` integer, nullable
    - `target_kubernetes_version` string, nullable
    - `upgrade_available` boolean
    - `upgrade_available_version` string, nullable
    - `scheduled_upgrade_date` string, date-time, nullable
    - `scheduled_upgrade_id` string, uuid, nullable
    - `component_bundle_version` string
    - `multi_region` boolean
    - `region_locations` string[], nullable
    - `is_byoc` boolean
    - `cloud_credential_id` string, uuid, nullable
    - `is_imported` boolean
    - `is_management` boolean
    - `is_autopilot` boolean
    - `display_order` integer, nullable
  - `total` integer, required

---

[API](https://skmtc.dev/mengi/apis/mengi-cloud.md) · [All operations](https://skmtc.dev/mengi/apis/mengi-cloud/llms.txt) · [OpenAPI document](https://skmtc.dev/mengi/apis/mengi-cloud/revisions/4ae9b375cdbb?raw)