Sign in

v5

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

Get cost trends with future projections

Get cost trends with future projections, segmented for a UI category.

Returns monthly cost data with projections to end of period — each graph point carries the per-segment breakdown for the requested category. Used for Future State visualization showing historical + projected costs.

get/api/v1/databricks/cost/overall/estimate

Query parameters

start_datestring date required

Start date (typically start of year)

Start date (typically start of year)

end_datestring date required

End date (typically end of year)

End date (typically end of year)

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 to segment the projection by. total → the 6 spec groups; sql_warehouse → Classic / Pro / Serverless; other values → the products of that spec group. Mirrors /cost/trends/by-product.

navigationSourcestring nullable

Headers

x-tenantstring required

Response

Successful Response

productsstring[]

Canonical segment legend for the requested category, in display order — includes segments with no data so the legend stays stable across date ranges.

currencystring

Currency code

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.