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

# Get Usage V1

> Tenant-scoped usage rollup. Returns lifetime totals (tokens, cost, job count), the by-status job breakdown, and current billing-period spend + quota state…

Tenant-scoped usage rollup.

Returns lifetime totals (tokens, cost, job count), the by-status job
breakdown, and current billing-period spend + quota state. Useful for
dashboards and pre-flight checks before queueing a large batch.

### Response

`app__api__routes__v1__trigger__UsageResponse`

<ResponseField name="total_jobs" type="integer" required />

<ResponseField name="total_tokens" type="integer" required />

<ResponseField name="total_cost_usd" type="number" required />

<ResponseField name="period_tasks_used" type="integer" required />

<ResponseField name="task_quota" type="integer" required />

<ResponseField name="period_cost_usd" type="number" required />

<ResponseField name="by_status" type="object" required />

<ResponseField name="billing_period_start" type="string,null" required />

<ResponseField name="billing_period_end" type="string,null" required />

### Status codes

| Code  | Meaning             |
| ----- | ------------------- |
| `200` | Successful Response |

<RequestExample>
  ```bash cURL theme={null}
  curl --request GET \
    --url 'https://api.computer.stateset.app/api/v1/usage' \
    --header 'X-API-Key: YOUR_API_KEY'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "total_jobs": 1,
    "total_tokens": 1,
    "total_cost_usd": 1.5,
    "period_tasks_used": 1,
    "task_quota": 1,
    "period_cost_usd": 1.5,
    "by_status": {},
    "billing_period_start": "string",
    "billing_period_end": "string"
  }
  ```
</ResponseExample>