---
title: "Get Costs"
method: GET
path: "/costs"
---

# Get Costs

`GET /costs`

## Request

- Base URL: `http://127.0.0.1:8052`
- URL: `http://127.0.0.1:8052/costs`
- Auth: none declared

Aggregate cost data across all runs.

Scans every persisted cost file in ``.sdd/runtime/costs/``, aggregates
per-agent and per-model totals, and computes cost attainment as
``(total_spent / total_budget) * 100``.  Budget of zero is treated as
unlimited - attainment is reported as 0.0 in that case.

## Query parameters

- `tenant` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `403`: Tenant access denied
- `404`: Tenant not found
- `422`: Validation Error

---

[API](https://skmtc.dev/bernstein/apis/bernstein-task-server.md) · [All operations](https://skmtc.dev/bernstein/apis/bernstein-task-server/llms.txt) · [OpenAPI document](https://skmtc.dev/bernstein/apis/bernstein-task-server/revisions/2a20a34ad2eb?raw)