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

# List clusters

`GET /clusters`

## Response `200`

Clusters list

- object[]
  - `id` number, nullable, required
  - `name` string, required
  - `hardware_description` string, nullable

## Other responses

- `401` — Invalid API key
- `500` — Internal server error

## Changes

- **2025-12-29** `0b475fbd2ae7` — 2 breaking, 4 warning, 2 info
  - removed the required property `items/machines` from the response with the `200` status
  - removed the required property `items/nickname` from the response with the `200` status
  - removed the optional property `items/cycle_type` from the response with the `200` status
  - removed the optional property `items/description` from the response with the `200` status
  - …4 more
- **2025-10-27** `4a5990e8263c` — 3 breaking
  - the response property `items/machines/items/machine/gpu_count` became optional for the status `200`
  - the response property `items/machines/items/machine/gpu_memory_gb` became optional for the status `200`
  - the response property `items/machines/items/machine/gpu_models` became optional for the status `200`
- **2025-04-15** `3c13481dd1c7` — 1 breaking, 1 info
  - removed the required property `items/cluster_configuration` from the response with the `200` status
  - added the required property `items/machines` to the response with the `200` status
- **2025-04-10** `419f210c58a9` — 3 info
  - added the required property `items/cluster_configuration/items/cluster_machine` to the response with the `200` status
  - added the required property `items/cluster_configuration/items/cluster_machine_count` to the response with the `200` status
  - added the required property `items/cluster_configuration/items/cluster_machine_id` to the response with the `200` status
- …earlier changes not shown

[Full history](https://skmtc.dev/ethproofs/apis/ethproofs-api/changes/clusters/get.md)

---

[API](https://skmtc.dev/ethproofs/apis/ethproofs-api.md) · [All operations](https://skmtc.dev/ethproofs/apis/ethproofs-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ethproofs/ethproofs-api/revisions/cad0595821db/schema)