---
title: "Cost Summary"
method: GET
path: "/api/cost/summary"
tags: ["cost"]
---

# Cost Summary

`GET /api/cost/summary`

Total cost by category for a given month (defaults to current month).

Returns per-category totals plus grand total.
Used by the Outreach Health dashboard cost breakdown widget.

## Query parameters

- `month` string, nullable — Month to summarize: YYYY-MM. Defaults to current month.

## Response `200`

Successful Response

- CostSummaryResponse
  - `month` string, required
  - `total_cents` integer, required
  - `total_dollars` number, required
  - `by_category` CostCategorySummary[], required
    - `category` string, required
    - `total_cents` integer, required
    - `total_dollars` number, required
    - `entry_count` integer, required
  - `generated_at` string, date-time, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/rethoric/apis/rethoric-os.md) · [All operations](https://skmtc.dev/rethoric/apis/rethoric-os/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/rethoric/rethoric-os/revisions/76b6d39426f6/schema)