---
title: "Get aggregate cost summary for the Jobs list"
method: GET
path: "/api/v1/databricks/jobs/summary"
tags: ["DATABRICKS", "Databricks", "Databricks Jobs"]
---

# Get aggregate cost summary for the Jobs list

`GET /api/v1/databricks/jobs/summary`

Aggregate cost summary feeding the Jobs page hero cards.

Returns Total Cost, Total DBU Cost, Total Cloud Cost, and Total
Realized Savings (summed from the ``dbx_jobs_cost_savings`` cost
mart). ``total_dbu_cost`` is ALWAYS DBU-only — ``service
.get_jobs_summary`` stays flag-agnostic, mirroring ``/cost/overview``'s
``_attach_cloud_cost`` pattern of keeping flag knowledge at the
endpoint. ``total_cost`` composes at this layer:

* ``showCloudCosts`` on AND the tenant has a real (non-``None``)
  ``total_cloud_cost`` -> ``total_cost = total_dbu_cost +
  total_cloud_cost`` (rounded from the already-rounded cloud figure,
  same rounding rule as ``cost_api._attach_cloud_cost``, so the three
  displayed numbers reconcile exactly).
* ``showCloudCosts`` off -> ``total_cloud_cost`` is forced ``null``
  and ``total_cost`` stays DBU-only.
* ``showCloudCosts`` on but no cloud-cost feed (``total_cloud_cost`` is
  ``None``) -> nothing to fold in; ``total_cost`` stays DBU-only.

## Query parameters

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

## Headers

- `x-tenant` string, required

## Response `200`

Successful Response

- JobsSummaryResponse — Aggregate cost summary for the Jobs list hero cards. ``total_dbu_cost`` is always DBU-only. ``total_cloud_cost`` is the job-attributed cloud infrastructure cost, ``None`` when the tenant has no cloud-cost feed. ``total_cost`` equals ``total_dbu_cost`` alone UNLESS the tenant's ``showCloudCosts`` flag is on and a real ``total_cloud_cost`` is available, in which case the API layer (``app.api.databricks.jobs_api.get_jobs_summary``) folds it in: ``total_cost = total_dbu_cost + total_cloud_cost``. This class itself stays flag-agnostic — it declares the shape, not the composition rule.
  - `total_cost` number
  - `total_dbu_cost` number
  - `total_cloud_cost` number, nullable
  - `total_realized_savings` number

## Other responses

- `403` — Not authorized
- `404` — No ClickHouse database configured
- `422` — Validation Error

---

[API](https://skmtc.dev/myaltimate/apis/fastapi.md) · [All operations](https://skmtc.dev/myaltimate/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc.dev/myaltimate/apis/fastapi/revisions/f06cba63189c?raw)