---
title: "Get cost trends with future projections"
method: GET
path: "/api/v1/databricks/cost/overall/estimate"
tags: ["DATABRICKS", "Databricks", "Databricks Cost"]
---

# Get cost trends with future projections

`GET /api/v1/databricks/cost/overall/estimate`

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.

## Query parameters

- `start_date` string, date, required — Start date (typically start of year)
- `end_date` string, date, required — End date (typically end of year)
- `workspace_id` string, 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.
- `navigationSource` string, nullable

## Headers

- `x-tenant` string, required

## Response `200`

Successful Response

- CostEstimateTrendsResponse — Response model for cost estimate/projection endpoint.
  - `graph` CostEstimateGraphItem[], required — Graph data with actual and projected costs
    - `date` string, required — Period date (ISO format)
    - `total` number — Actual total cost for the period
    - `total_estimate` number — Projected total cost for the period
    - `is_estimate` boolean — Whether this is a projected period
    - `percentage_total` number, nullable — Percentage change in total from previous period
    - `segments` EstimateSegmentItem[] — Per-segment actual + projected costs for the requested ``category``, in canonical legend order. The segment set matches the ``products`` array on the response.
      - `product` string, required — Segment label for this category
      - `cost` number — Actual cost for the period
      - `cost_estimate` number — Projected cost for the period
      - `percentage_change` number, nullable — Percentage change from the previous period
  - `products` string[] — Canonical segment legend for the requested ``category``, in display order — includes segments with no data so the legend stays stable across date ranges.
  - `currency` string — 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.

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