---
title: "Get all Databricks clusters"
method: GET
path: "/api/v1/databricks/clusters"
tags: ["DATABRICKS", "Databricks", "Databricks Clusters"]
---

# Get all Databricks clusters

`GET /api/v1/databricks/clusters`

Get list of all clusters with utilization metrics.

## Query parameters

- `workspace_id` string, nullable — Filter by workspace ID
- `start_date` string, date, nullable — Start date (inclusive) for utilization/cost metrics. Defaults to 30 days before `end_date`.
- `end_date` string, date, nullable — End date (inclusive). Defaults to today.
- `page` integer — Page number (1-indexed)
- `page_size` integer — Items per page
- `sortAttribute` string, nullable — Sort column name. Valid columns: avg_cpu, avg_memory, total_cost, auto_tune_savings. Sorting by inventory columns (cluster_name, node types, ...) is not supported.
- `sortOrder` 'asc' | 'desc', nullable — Sort direction: 'asc' or 'desc'
- `cluster_names` string[], nullable — Filter by cluster names
- `workspaces` string[], nullable — Filter by workspace names
- `compute_type` string[], nullable — Filter by compute type(s): 'all_purpose', 'jobs', 'dlt'
- `enable_photon` boolean, nullable — Filter by Photon enablement. True returns only Photon-enabled clusters; False returns only clusters where Photon is off. Omit to include all.
- `navigationSource` string, nullable

## Headers

- `x-tenant` string, required

## Response `200`

Successful Response

- ClustersResponse — Response for listing clusters.
  - `clusters` ClusterSummary[], required
    - `cluster_id` string, required
    - `cluster_name` string, required
    - `workspace_id` string, required
    - `workspace_name` string, nullable
    - `instance_id` integer, nullable
    - `driver_node_type` string, nullable
    - `worker_node_type` string, nullable
    - `worker_count` integer, nullable
    - `min_autoscale_workers` integer, nullable
    - `max_autoscale_workers` integer, nullable
    - `cluster_source` string, nullable
    - `compute_type` string, nullable — Derived compute classification: 'all_purpose', 'jobs', or 'serverless'.
    - `enable_photon` boolean, nullable — Whether the cluster runs a Photon runtime, derived from the runtime version. Null when the version is unknown.
    - `state` string, nullable
    - `last_state_change` string, date-time, nullable
    - `avg_cpu` number
    - `avg_memory` number
    - `sample_count` integer
    - `total_cost` number
    - `realized_savings` number, nullable
    - `estimated_annualized_savings` number, nullable
    - `is_auto_tune_enabled` string, nullable
  - `total_count` integer, required — Total number of clusters
  - `page` integer — Current page number
  - `page_size` integer — Number of items per page
  - `total_pages` integer — Total number of pages

## Other responses

- `403` — Not authorized
- `404` — No ClickHouse database configured
- `422` — Validation Error

---

[API](https://skmtc.net/myaltimate/apis/fastapi.md) · [All operations](https://skmtc.net/myaltimate/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/myaltimate/fastapi/versions/103580dad816/schema)