---
title: "What this key has spent, and what is left"
method: GET
path: "/api/v1/won/usage"
tags: ["won"]
---

# What this key has spent, and what is left

`GET /api/v1/won/usage`

## Request

- Base URL: `https://api.wontopos.com`
- URL: `https://api.wontopos.com/api/v1/won/usage`
- Auth: API key in header `X-API-Key`

Answers "can I keep going?". Returns this API key's lifetime spend, its workspace's spend over the last `days` days, and the prepaid balance that gates the next call. Priced through the same path as the balance itself, so the figure here and the amount actually charged cannot disagree. Carries NO charge and skips the balance gate — an account at zero must still be able to find out why. Rate limited to 10 requests per minute.

## Query parameters

- `days` integer

## Response `200`

Spend for the calling key and its workspace, with the balance that gates it.

- object
  - `window_days` integer: Days covered by the workspace figures.
  - `key` object: This key only — never a roster of the account's other keys.
    - `requests` integer
    - `cost_cents` number: Lifetime, priced at each serving model's rate plus the per-request fee.
    - `input_tokens` integer
    - `output_tokens` integer
    - `since` 'lifetime'
  - `workspace` object: The workspace this key belongs to, over the requested window.
    - `workspace_id` string, nullable
    - `requests` integer
    - `cost_cents` number
  - `stores` object[]: Per-store spend over the window, highest spend first, at most 50. `other` is the overflow bucket once an account meters more than 200 distinct stores in a day, not a real store.
    - `store` string
    - `requests` integer
    - `cost_cents` number
  - `balance_cents` number: Prepaid balance left on the account. Negative means overdrawn.
  - `expiring_soon_cents` number: Of what is left, how much expires within 90 days.

---

[API](https://skmtc.dev/wontopos/apis/wontopos-memory-api.md) · [All operations](https://skmtc.dev/wontopos/apis/wontopos-memory-api/llms.txt) · [OpenAPI document](https://skmtc.dev/wontopos/apis/wontopos-memory-api/revisions/48dda7326a33?raw)