Sign in

v5

latestOpenAPI 3.1.02026-08-081,0211,3082.1 MB
DATABRICKS
Databricks
Databricks Cost

Get Databricks cost trends by product over time

Get cost trends over time, sliced for a UI category.

Returns time series data with DBU consumption and estimated cost per period, with each row labelled by the category's chosen segment. The products array in the response is the canonical legend for the category (in display order, including segments with no data) so the FE legend stays stable across date ranges.

get/api/v1/databricks/cost/trends/by-product

Query parameters

start_datestring date required

Start date for the period

Start date for the period

end_datestring date

End date for the period

End date for the period

granularitystring

Time granularity: 'day', 'week', or 'month'

Time granularity: 'day', 'week', or 'month'

workspace_idstring nullable

Filter by workspace ID

Filter by workspace ID

category'total' | 'clusters' | 'sql_warehouse' | 'ai_ml' | 'lakehouse' | 'platform'

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.

Which UI category the chart is for. Drives both the product filter and the per-row segment label. total returns the 5 spec-group stack (Clusters / SQL Warehouse / AI/ML / Lakehouse / Platform). sql_warehouse returns Classic / Pro / Serverless. Other values return the products in that spec group.

navigationSourcestring nullable

Headers

x-tenantstring required

Response

Successful Response

productsstring[] required

Canonical segment labels for the chart legend, in display order. When called with a category, this is the full set of expected segments for that category — empty segments are still included so the legend stays stable across date ranges.

granularitystring required

Time granularity (day/week/month)

category'total' | 'clusters' | 'sql_warehouse' | 'ai_ml' | 'lakehouse' | 'platform'

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.