---
title: "Get Usage Summary"
method: GET
path: "/api/usage/summary"
---

# Get Usage Summary

`GET /api/usage/summary`

Activity-card aggregates: per-bucket totals + grand totals for
the requested time window. `period` ∈ {24h, 7d, 1m, 3m, all}.
`group_by` ∈ {model, provider, agent}. Buckets sorted by
total_tokens DESC so the UI can take top-N directly.

## Query parameters

- `period` string
- `group_by` string

## Headers

- `authorization` string, nullable

## Response `200`

Successful Response

- object

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/omicos/apis/omicos-server.md) · [All operations](https://skmtc.dev/omicos/apis/omicos-server/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/omicos/omicos-server/revisions/a00b94573ffe/schema)