---
title: "Get Token Usage"
method: GET
path: "/payment/token-usage"
tags: ["PAYMENT"]
---

# Get Token Usage

`GET /payment/token-usage`

Token usage for UI progress bar.

## Headers

- `x-tenant` string

## Response `200`

Successful Response

- TokenUsageResponse — Token usage data for UI progress bar + wallet state.
  - `credit_type` string, required
  - `unlimited` boolean
  - `total_tokens` integer
  - `total_consumed` integer
  - `total_remaining` integer
  - `tokens_consumed` integer
  - `tokens_included` integer
  - `tokens_remaining` integer
  - `overage_tokens` integer
  - `overage_rate_cents_per_million` integer
  - `grant_tokens_total` integer
  - `grant_tokens_consumed` integer
  - `grant_tokens_remaining` integer
  - `period_start` string, nullable
  - `period_end` string, nullable
  - `wallet_balance_cents` number
  - `wallet_spend_this_period_cents` number

## Other responses

- `422` — Validation Error

---

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