Where did you hear about us?
1 of 6
Won — calls for the model

What this key has spent, and what is left

GET/api/v1/won/usage

In the SDKs: usage

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.

Authentication

Every call carries your API key in an X-API-Key header. Keys are created in the console.

Request body

None. This call takes no JSON body.

Returns

The 200 body. Fields nested one level are shown as parent.child.

window_days integer

Days covered by the workspace figures.

key object

This key only — never a roster of the account's other keys.

key.requests integer
key.cost_cents number

Lifetime, priced at each serving model's rate plus the per-request fee.

key.input_tokens integer
key.output_tokens integer
key.since "lifetime"
workspace object

The workspace this key belongs to, over the requested window.

workspace.workspace_id string,null
workspace.requests integer
workspace.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.

stores.store string
stores.requests integer
stores.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.

Example

cURL
curl -X GET https://api.wontopos.com/api/v1/won/usage \
  -H "X-API-Key: $WOS_API_KEY"

Status codes

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

Rate limits per tier and the full status list are in Errors & limits.

In the SDKs

The Python, TypeScript, and Rust SDKs wrap this endpoint so you do not build the request by hand — pip install wontopos, npm i wontopos, or cargo add wontopos, then the method list is on the SDK reference. A coding agent can take the whole API in one file at llms.txt, or over MCP with npx -y wontopos-mcp.