# Get AI usage

`GET /v1/ai-usage`

**In this build:** Real.

**Scope:** `account.read`

**CLI:** `harebox ai usage`

## Query

`since`, `until`

## Response: 200

`UsageReport`

| Field | Type | Notes |
|---|---|---|
| `since` (required) | `string` |  |
| `until` (required) | `string` |  |
| `total_usd` (required) | `number` |  |
| `billed_seconds` | `integer` |  |
| `sleep_seconds` | `integer` | Time asleep, billed like running time. |
| `groups` | `array` |  |
| `ai` | `object` |  |

Errors follow [one format](../errors.html).