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

# Get efficiency metrics per workspace

`GET /api/v1/databricks/cost/workspace-efficiency`

Get efficiency metrics per workspace for chargeback and analysis.

Returns per-workspace metrics including:
- Total DBUs and cost
- Jobs vs All-Purpose percentage
- Serverless percentage
- Efficiency score (healthy, moderate, unhealthy)

## Query parameters

- `start_date` string, date, required — Start date for the period
- `end_date` string, date — End date for the period
- `navigationSource` string, nullable

## Headers

- `x-tenant` string, required

## Response `200`

Successful Response

- WorkspaceEfficiencyResponse — Response model for workspace efficiency endpoint.
  - `workspaces` WorkspaceEfficiencyItem[], required — List of workspace efficiency metrics
    - `workspace_id` string, required — Databricks workspace ID
    - `workspace_name` string, nullable — Workspace display name
    - `total_dbus` number, required — Total DBU consumption
    - `estimated_cost` number, required — Estimated cost
    - `jobs_pct` number, required — Percentage of compute used by Jobs
    - `all_purpose_pct` number, required — Percentage of compute used by All-Purpose
    - `serverless_pct` number, required — Percentage of compute that is serverless
    - `efficiency_score` string, required — Efficiency rating: healthy (>70% jobs), moderate (50-70%), unhealthy (<50%)
  - `total_dbus` number, required — Total DBUs across all workspaces
  - `total_cost` number, required — Total cost across all workspaces

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