---
title: "What this key has spent (alias of /api/v1/won/usage)"
method: GET
path: "/api/v1/memory/usage"
tags: ["memory"]
---

# What this key has spent (alias of /api/v1/won/usage)

`GET /api/v1/memory/usage`

## Request

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

Identical behaviour and rate-limit budget — see /api/v1/won/usage.

## 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)