> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qingbo.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Get usage

> OpenAI-compatible cumulative usage lookup

Returns the account's **cumulative usage** in the same shape as OpenAI's `/dashboard/billing/usage`, so existing credit-checking tools work against it unchanged.

<Warning>
  Two things catch people out: `total_usage` is in **cents** (USD × 100), not dollars; and this endpoint **ignores `start_date` / `end_date`** — a wallet reports a cumulative figure, not a per-day slice.
</Warning>

<RequestExample>
  ```bash cURL theme={"system"}
  curl https://www.qingbo.dev/v1/dashboard/billing/usage \
    -H "Authorization: Bearer $WAVE_API_KEY"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={"system"}
  {
    "object": "list",
    "total_usage": 348.2914
  }
  ```
</ResponseExample>

## Authorizations

<ParamField header="Authorization" type="string" required>
  `Bearer YOUR_API_KEY`.
</ParamField>

## Response

<ResponseField name="object" type="string">
  Always `list`.
</ResponseField>

<ResponseField name="total_usage" type="number">
  Usage to date, **in cents**. Divide by 100 for dollars — the `348.2914` above is \$3.482914.
</ResponseField>

## Deriving the remaining balance

OpenAI's tools compute what is left as total credit minus usage:

```text theme={"system"}
remaining USD = subscription.hard_limit_usd - usage.total_usage / 100
```

[Get balance](/en/api-reference/account/balance) returns the remaining balance directly as `total_available_usd`, with no subtraction needed.

## Related

* [Get balance](/en/api-reference/account/balance)
* [Get subscription](/en/api-reference/account/subscription)