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

# Get clusters

`GET /v1/clusters`

Return all clusters of the project

## Response `200`

List of clusters

- GetClusterResponsePublicApiDto[]
  - `id` string, required
  - `ip` string, required — Jump host IP address
  - `status` 'running' | 'provisioning' | 'offline' | 'discontinued' | 'unknown' | 'ordered' | 'notfound' | 'new' | 'error' | 'deleting' | 'validating' | 'no_capacity' | 'installation_failed', required
  - `created_at` string, required
  - `created_by_user_id` string
  - `cpu` object, required
  - `gpu` object, required
  - `gpu_memory` object, required
  - `memory` object, required
  - `hostname` string, required
  - `description` string, required
  - `tags` TagResponseDto[], required
    - `id` string, required
    - `key` string, required
    - `value` string, required — Empty string for a freeform tag
  - `location` string, required
  - `price_per_hour` number, required
  - `cluster_type` string, required
  - `image` string, required — OS image used to deploy the cluster nodes
  - `os_name` string, required
  - `startup_script_id` string
  - `ssh_key_ids` string[], required — SSH key IDs used to access the cluster jump host
  - `contract` 'LONG_TERM' | 'PAY_AS_YOU_GO', required — Contract type used for this cluster
  - `auto_rental_extension` boolean — Deprecated: use extension_settings instead.
  - `turn_to_pay_as_you_go` boolean — Deprecated: use extension_settings instead.
  - `extension_settings` 'auto_renew' | 'pay_as_you_go' | 'end_contract' — Extension settings for long-term contracts
  - `long_term_period` string — Long-term rental period for this cluster, e.g. 1 week etc.
  - `worker_nodes` string[] — Worker nodes of this cluster. You can access them from the jump host by executing `ssh <hostname>`
  - `shared_volumes` string[] — Shared volumes attached to this cluster. There is always one shared volume mounted as /home.

---

[API](https://skmtc.net/datacrunch/apis/verda-cloud-public-api.md) · [All operations](https://skmtc.net/datacrunch/apis/verda-cloud-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/datacrunch/verda-cloud-public-api/revisions/0d66c7340876/schema)