# Usage

Source: https://www.hotdata.dev/docs/api-reference/usage
Site index: https://www.hotdata.dev/llms.txt

## Get workspace usage snapshot

`GET /v1/usage`

Return aggregated bytes scanned and current storage size for a billing period. Pass `since` as the start of your billing period so the totals line up with your invoice rather than the calendar month.

**Query parameters**

- `since` `string` — Billing period start (ISO-8601). Defaults to the start of the current UTC calendar month when omitted.

**Response** `200` — Workspace usage snapshot

- `bytes_scanned` `integer` — **required**. Sum of `bytes_scanned` across all completed/failed query runs since `since`. Null bytes (queries that touched no row data) contribute 0.
- `query_count` `integer` — **required**. Number of query runs (succeeded + failed) since `since`.
- `since` `string` — **required**. The period start used for this response (echoed back for the caller to verify).
- `storage_bytes` `integer` — **required**. The workspace's current stored-data footprint in bytes, measured at request time: instant-database data, plus un-consumed uploads, connection caches, and search-index artifacts.
- `storage_captured_at` `string,null` — When `storage_bytes` was measured (the time this response was produced).

```json
{
  "bytes_scanned": 0,
  "query_count": 0,
  "since": "2026-01-01T00:00:00Z",
  "storage_bytes": 0,
  "storage_captured_at": "2026-01-01T00:00:00Z"
}
```