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

# Usage by model

> Per-model request, token and cost totals for your account.

<ParamField query="days" type="integer" default="30">
  How far back to look, in days. **Defaults to 30** when omitted, and is clamped to a
  maximum of **366**. A value below 1, or one that is not a number, falls back to 30.

  The default is not "all time". Asking for every row an account has ever written costs
  seconds on a busy account and almost nobody wants it — the dashboard always sends an
  explicit window, so this default only covers callers that name none. Ask for the window
  you want.
</ParamField>

## Response

```json theme={null}
{
  "models": [
    {
      "model": "qwen-3.6-plus",
      "requests": 412,
      "prompt_tokens": 1830244,
      "completion_tokens": 51022,
      "total_tokens": 1881266,
      "cost": 1.4732
    }
  ]
}
```

`cost` is what you were charged, in US dollars, over the window. Models you did not call
in the window are absent rather than present with zeros.

<RequestExample>
  ```bash cURL theme={null}
  curl "https://kymaapi.com/v1/auth/usage/models?days=7" \
    -H "Authorization: Bearer ks-your-session-token"
  ```
</RequestExample>