---
title: "Get Token Usage"
method: GET
path: "/api/admin/usage/tokens"
---

# Get Token Usage

`GET /api/admin/usage/tokens`

## Request

- Base URL: `https://api.yourbeckett.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.yourbeckett.com/api/admin/usage/tokens`
- Auth: none declared

Platform-wide token usage summary (admin only).

## Query parameters

- `period` string
- `timezone` string, nullable
- `avg_cost_start` string, nullable: ISO date for avg cost calculation start (default: 2026-02-22)

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/yourbeckett/apis/beckett-platform.md) · [All operations](https://skmtc.dev/yourbeckett/apis/beckett-platform/llms.txt) · [OpenAPI document](https://skmtc.dev/yourbeckett/apis/beckett-platform/revisions/a1cb8f2c8961?raw)
