---
title: "Get Databricks cost overview"
method: GET
path: "/api/v1/databricks/cost/overview"
tags: ["DATABRICKS", "Databricks", "Databricks Cost"]
---

# Get Databricks cost overview

`GET /api/v1/databricks/cost/overview`

Get cost overview with summary metrics.

Returns total DBUs, estimated cost, and period-over-period comparison.

## Query parameters

- `start_date` string, date, required — Start date for the period
- `end_date` string, date — End date for the period
- `workspace_id` string, nullable — Filter by workspace ID
- `navigationSource` string, nullable

## Headers

- `x-tenant` string, required

## Response `200`

Successful Response

- CostOverviewResponse — Response model for cost overview endpoint.
  - `total_dbus` number, required — Total DBU consumption
  - `estimated_cost` number, required — Estimated cost in USD
  - `days_count` integer, required — Number of days in the period
  - `workspace_count` integer, required — Number of active workspaces
  - `sku_count` integer, required — Number of distinct SKUs
  - `delta_pct` number, nullable — Percentage change vs previous period
  - `daily_average_dbus` number, required — Average daily DBU consumption
  - `category_breakdown` CostCategoryItem[] — Per-category cost & DBU breakdown for the 5 spec groups, in canonical legend order (Clusters → SQL Warehouse → AI/ML → Lakehouse → Platform). Empty categories are included with zero values so the FE can keep colour ordering stable.
    - `category` 'total' | 'clusters' | 'sql_warehouse' | 'ai_ml' | 'lakehouse' | 'platform', required — Spec-group category identifier shared across the cost APIs. Used by: * ``GET /cost/trends/by-product?category=<value>`` — selects which products get filtered in and how each row's segment label is computed. * ``GET /cost/overview`` — each ``category_breakdown`` item carries one of these values. See ``CATEGORY_DEFINITIONS`` in ``app.service.databricks.cost_constants`` for the per-category filter list, segment label expression, and canonical legend order.
    - `label` string, required — Display label for the category (e.g. ``Clusters``, ``SQL Warehouse``). Matches the legend label used by ``/cost/trends/by-product?category=total``.
    - `total_dbus` number, required — Total DBUs for this category
    - `estimated_cost` number, required — Estimated cost for this category
    - `pct_of_total` number, required — Share of the overall ``estimated_cost`` (0–100, one decimal). Sums to ~100 across the breakdown.

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