---
title: "Get Token Usage Summary"
method: GET
path: "/api/v1/ledger/token-usage-summary"
tags: ["User APIs", "ledger-platform"]
---

# Get Token Usage Summary

`GET /api/v1/ledger/token-usage-summary`

PRO-1894: Platform (org wallet + Group/User limits) and MCP
(org/Group/User limits) usage for the authenticated user's top-bar
popover, in one call.

## Response `200`

Successful Response

- TokenUsageSummaryResponse — PRO-1894: aggregates every tier the top-bar usage popover needs (org wallet/limit, Group limit, User limit) for both Platform and MCP tokens in one self-service call, reusing the same data already surfaced individually via wallet-summary / mcp/daily-window / the admin Group and User consumption-limit fields.
  - `platform` PlatformTokenUsageRead, required
    - `wallet_balance` number, required
    - `group` TokenTierRead, required — One group/user consumption-limit tier for PRO-1894's token usage popover. ``present=False`` means the scope doesn't apply to this user (e.g. no Group, or the limit was never set) — the frontend hides the row rather than treating a missing cap as zero.
      - `present` boolean, required
      - `used` number, nullable
      - `cap` number, nullable
      - `next_reset_at` string, date-time, nullable
    - `user` TokenTierRead, required — One group/user consumption-limit tier for PRO-1894's token usage popover. ``present=False`` means the scope doesn't apply to this user (e.g. no Group, or the limit was never set) — the frontend hides the row rather than treating a missing cap as zero.
      - `present` boolean, required
      - `used` number, nullable
      - `cap` number, nullable
      - `next_reset_at` string, date-time, nullable
  - `mcp` McpTokenUsageRead, required
    - `org_limit` number, nullable
    - `org_used` number, required
    - `org_next_reset_at` string, date-time, required
    - `group` TokenTierRead, required — One group/user consumption-limit tier for PRO-1894's token usage popover. ``present=False`` means the scope doesn't apply to this user (e.g. no Group, or the limit was never set) — the frontend hides the row rather than treating a missing cap as zero.
      - `present` boolean, required
      - `used` number, nullable
      - `cap` number, nullable
      - `next_reset_at` string, date-time, nullable
    - `user` TokenTierRead, required — One group/user consumption-limit tier for PRO-1894's token usage popover. ``present=False`` means the scope doesn't apply to this user (e.g. no Group, or the limit was never set) — the frontend hides the row rather than treating a missing cap as zero.
      - `present` boolean, required
      - `used` number, nullable
      - `cap` number, nullable
      - `next_reset_at` string, date-time, nullable

---

[API](https://skmtc.net/carbonarc/apis/carbon-arc-client-admin-api.md) · [All operations](https://skmtc.net/carbonarc/apis/carbon-arc-client-admin-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/carbonarc/carbon-arc-client-admin-api/revisions/a8ca30023371/schema)