DATABRICKS
Databricks
Databricks Cost

Get total estimated cost for the year

Changed on

Get total estimated cost for the period (actual + projected).

Returns the grand total plus a per-segment breakdown for the requested category. Used for Future State total cost display. With showCloudCosts on and category=total, total also includes the projected calendar-year cloud cost, exposed as cloud_cost.

get/api/v1/databricks/cost/total/estimate

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/cost/total/estimate
  • Auth: one of:
    • HTTP bearer
    • HTTP bearer

Query parameters

start_datestring date required

Start date (typically start of year)

end_datestring date required

End date (typically end of year)

workspace_idstring nullable

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 estimate by. See /cost/overall/estimate for the segmentation rules.

navigationSourcestring nullable

Headers

x-tenantstring required

Response

Successful Response

totalnumber required

Total cost (actual + projected)

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.

cloud_costnumber nullable

Projected calendar-year cloud infrastructure cost (actual + month-end estimate), included in total. Present only when showCloudCosts is on, category is total and the tenant has cloud-cost data this year; otherwise null and total is DBU-only.

Changes