---
title: "Get serverless migration candidates"
method: GET
path: "/api/v1/databricks/warehouses/serverless-candidates"
tags: ["DATABRICKS", "Databricks", "Databricks Warehouses"]
---

# Get serverless migration candidates

`GET /api/v1/databricks/warehouses/serverless-candidates`

Get warehouses that are candidates for serverless migration.

## Query parameters

- `max_auto_stop_mins` integer, nullable — Maximum auto-stop time (minutes) for candidates. Warehouses with `auto_stop_mins <= this value` are returned — lower values yield a stricter filter. Defaults to 10 when neither this nor the deprecated `min_auto_stop_mins` alias is sent.
- `min_auto_stop_mins` integer, nullable — DEPRECATED — use `max_auto_stop_mins`. Kept for backward compat.
- `workspace_id` string, nullable — Filter by workspace ID
- `navigationSource` string, nullable

## Headers

- `x-tenant` string, required

## Response `200`

Successful Response

- AppSchemasDatabricksWarehouseServerlessCandidatesResponse — Response for serverless candidates.
  - `candidates` ServerlessCandidate[], required
    - `warehouse_id` string, required
    - `warehouse_name` string, required
    - `workspace_id` string, required
    - `workspace_name` string, nullable
    - `warehouse_type` string, nullable
    - `warehouse_size` string, nullable
    - `auto_stop_mins` integer, nullable
    - `enable_serverless_compute` boolean, nullable
  - `total_count` integer, required

## 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/50769cbf05d5/schema)