---
title: "Api Dashboard Breakdown Retrieve"
method: GET
path: "/api/dashboard/breakdown/"
tags: ["dashboard"]
---

# Api Dashboard Breakdown Retrieve

`GET /api/dashboard/breakdown/`

GET/POST dashboard/breakdown/?breakdown_by=<dimension> -- top-N breakdown
of LLM metrics grouped by one dimension.

Single parameterized replacement for the legacy per-dimension
dashboard/top-<x>/ endpoints (top-keys, top-models, top-providers,
top-prompts, top-deployments, top-users), which were retired once the FE
moved to ?breakdown_by=<dimension> (respan-frontend #2409). See
BE_conventions/urls.md "Dashboard breakdown (parameterized exception)".

Args (query params): breakdown_by, sort_by, summary_type, date,
    timezone_offset, is_test, all_envs
Args (POST body): filters
Response: {<sort_by_metric>: [{<dimension>, name, <metric_value>, ...}]}

## Headers

- `Authorization` string, required

## Response `200`

No response body

- DashboardApiDashboardBreakdownRetrieveResponse200 — Empty response body

---

[API](https://skmtc.net/keywordsai/apis/api-reference.md) · [All operations](https://skmtc.net/keywordsai/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/keywordsai/api-reference/versions/c26d550029f8/schema)