---
title: "Get a two-dimension usage breakdown"
method: GET
path: "/admin/usage/breakdown"
tags: ["admin"]
---

# Get a two-dimension usage breakdown

`GET /admin/usage/breakdown`

## Request

- Base URL: `http://localhost:8080`
- URL: `http://localhost:8080/admin/usage/breakdown`
- Auth: HTTP bearer

Pivots the filtered usage by a row and an optional column dimension. Keys rank by the metric; those past limit fold into a trailing "other" key. Period keys follow interval and are never folded. A request with several labels counts once per label.

## Query parameters

- `rows` string, required
- `columns` string
- `metric` string
- `limit` integer
- `user_path_depth` integer
- `days` integer
- `start_date` string
- `end_date` string
- `interval` string
- `model` string[]
- `provider` string[]
- `label` string[]
- `endpoint` string[]
- `operation` string
- `session_id` string
- `auth_key_id` string[]
- `user_path` string[]
- `cache_mode` string

## Response `200`

OK

- UsageUsageBreakdown
  - `cells` UsageBreakdownCell[]
    - `billed_cost` number, nullable
    - `column` integer
    - `input_tokens` integer
    - `output_tokens` integer
    - `requests` integer
    - `row` integer
    - `total_cost` number, nullable
    - `total_tokens` integer
  - `column_dimension` '' | 'model' | 'provider' | 'user_path' | 'label' | 'endpoint' | 'auth_key' | 'period'
  - `columns` UsageBreakdownKey[]
    - `folded` integer
    - `key` string
    - `other` boolean
  - `metric` 'cost' | 'tokens' | 'requests'
  - `row_dimension` '' | 'model' | 'provider' | 'user_path' | 'label' | 'endpoint' | 'auth_key' | 'period'
  - `rows` UsageBreakdownKey[]
    - `folded` integer
    - `key` string
    - `other` boolean

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden

## Changes

- **2026-10-26** `02fb28c7e1e3`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/enterpilot/apis/gomodel-api/changes/admin/usage/breakdown/get.md)

---

[API](https://skmtc.dev/enterpilot/apis/gomodel-api.md) - [All operations](https://skmtc.dev/enterpilot/apis/gomodel-api/llms.txt) - [OpenAPI document](https://skmtc.dev/enterpilot/apis/gomodel-api/revisions/02d5643d7bec?raw)