---
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`

## Request

- Base URL: `https://api.myaltimate.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.myaltimate.com/api/v1/databricks/clusters`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

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.dev/myaltimate/apis/myaltimate-api.md) - [All operations](https://skmtc.dev/myaltimate/apis/myaltimate-api/llms.txt) - [OpenAPI document](https://skmtc.dev/myaltimate/apis/myaltimate-api/revisions/727657ce54e9?raw)