---
title: "Retrieve all clusters"
method: GET
path: "/clusters"
tags: ["clusters"]
---

# Retrieve all clusters

`GET /clusters`

## Request

- Base URL: `https://pmp-demo.privateplatform.mendix.com/clusterservice/v1`
- URL: `https://pmp-demo.privateplatform.mendix.com/clusterservice/v1/clusters`
- Auth: one of:
  - HTTP basic
  - API key in header `Authorization`

Retrieve all clusters

## Response `200`

List of Clusters

- array[]
  - Cluster[]
    - `clusterId` string
    - `clusterName` string
    - `description` string
    - `clusterType` 'AKS' | 'EKS' | 'GKE' | 'OpenShift' | 'Kubernetes'
    - `deployMode` 'Standalone' | 'Connected'
    - `apiServerURL` string: API server URL of the cluster. Applicable only for Standalone mode clusters.
    - `token` string: Token for API token for access the cluster. Applicable only for Standalone mode clusters.
    - `secretSource` 'AWS' | 'DB' | 'AZURE' | 'HASHICORP': Secret source for API token for access the cluster. Required only for Standalone mode clusters. AWS is AWS Secrets Manager, DB is Database, AZURE is Azure Key Vault, HASHICORP is HashiCorp Vault.
    - `secretName` string: Secret name for API token for access the cluster. Applicable only for Standalone mode clusters.
    - `enableLogging` 'Yes' | 'No'
    - `enableMonitoring` 'Yes' | 'No'
    - `registryOciURL` string: OCI URL for the container registry. Optional only for Standalone mode clusters.
    - `grafanaConfig` object
      - `host` string
      - `apiKey` string
      - `datasourceType` 'Loki' | 'Azure_Monitor': Grafana data source type for logging and monitoring.
      - `loki` string
      - `prometheus` string
      - `secretSource` 'AWS' | 'DB' | 'AZURE' | 'HASHICORP': Secret source for API key for access the Grafana data source. AWS is AWS Secrets Manager, DB is Database, AZURE is Azure Key Vault, HASHICORP is HashiCorp Vault.
      - `secretName` string: Secret name for API key for access the Grafana data source.
      - `azureMonitorName` string
      - `aksName` string
      - `aksResourceID` string

## Other responses

- `401`: Authentication information is missing or invalid
- `403`: User has no permission for this operation
- `404`: Resource not found

---

[API](https://skmtc.dev/mendix/apis/cluster-service-v1.md) - [All operations](https://skmtc.dev/mendix/apis/cluster-service-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/mendix/apis/cluster-service-v1/revisions/ce8d4c9c1a02?raw)