---
title: "Get usage status"
method: GET
path: "/usage"
tags: ["Usage"]
---

# Get usage status

`GET /usage`

Report the authenticated account's current usage against its plan.

Returns whether the account still has usage available (`hasUsageRemaining`), the percentage of plan usage consumed this billing period, the billing-period bounds, and — only when extra usage is enabled — the extra-usage spend and limit in USD cents.

### Example

```bash
curl https://elicit.com/api/v2/usage \
  -H "Authorization: Bearer elk_live_your_key_here"
```

## Response `200`

Current usage status.

- GetUsageResponse
  - `hasUsageRemaining` boolean, required — Whether the account still has usage available this billing period. False once both the plan limit and (if enabled) the extra-usage limit are exhausted.
  - `percentUsed` number, required — Percentage of plan usage consumed this billing period.
  - `periodStart` string, required — ISO 8601 start of the current billing period.
  - `periodEnd` string, required — ISO 8601 end of the current billing period. Monthly usage limits reset at this time.
  - `extraUsage` ExtraUsage, required
    - `limitUsdCents` integer, nullable, required — The extra-usage spending limit in USD cents, or null when extra usage is uncapped.
    - `spentUsdCents` integer, required — Extra-usage spend so far this billing period, in USD cents.

## Other responses

- `401` — Authentication failed. The API key is missing, invalid, revoked, or expired.
- `403` — API access is not available on your current plan. Upgrade to Pro or above to use the API.
- `409` — Usage reporting is not available for this account, or usage data is not ready yet.

---

[API](https://skmtc.dev/elicit/apis/elicit-api.md) · [All operations](https://skmtc.dev/elicit/apis/elicit-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/elicit/elicit-api/revisions/2b42624536e5/schema)