---
title: "Get the caller's org cost breakdown"
method: GET
path: "/billing/breakdown"
tags: ["Billing"]
---

# Get the caller's org cost breakdown

`GET /billing/breakdown`

## Request

- Base URL: `https://api-docs.jackhamr.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api-docs.jackhamr.ai/billing/breakdown`
- Auth: none declared

Return costs broken down by category (default), agent, or user.

Delegates to
:func:`~app.services.billing._queries.get_org_breakdown`.

## Query parameters

- `period_start` string, date-time, nullable: Start of period (ISO 8601)
- `period_end` string, date-time, nullable: End of period (ISO 8601)
- `group_by` string: Group by: category, agent, or user

## Response `200`

Successful Response

- BillingBreakdown: Costs broken down by category, agent, or user.
  - `organization_id` string, required
  - `period_start` string, date-time, required
  - `period_end` string, date-time, required
  - `group_by` string
  - `categories` object[], nullable
  - `agents` object[], nullable
  - `users` object[], nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/jackhamr/apis/jackhamr-api.md) · [All operations](https://skmtc.dev/jackhamr/apis/jackhamr-api/llms.txt) · [OpenAPI document](https://skmtc.dev/jackhamr/apis/jackhamr-api/revisions/f75d221481d8?raw)