---
title: "Get percentage-based usage status"
method: GET
path: "/api/usage/status"
---

# Get percentage-based usage status

`GET /api/usage/status`

## Request

- Base URL: `https://api.aetherya.ai`
- URL: `https://api.aetherya.ai/api/usage/status`
- Auth: HTTP bearer

Returns weekly and monthly percentages, reset times, concurrency state, and the exact purchased Aetherya Credit balance. Raw included unit allowances are never returned.

## Headers

- `X-Aetherya-Workspace-Id` string

## Response `200`

Current usage status.

- object
  - `planKey` string, required
  - `policyVersion` integer
  - `weekly` UsageWindow, required
    - `percentUsed` number, required
    - `resetsAt` string, date-time, required
  - `monthly` UsageWindow, required
    - `percentUsed` number, required
    - `resetsAt` string, date-time, required
  - `concurrency` object, required
    - `inUse` integer
    - `limit` integer
  - `credits` object, required
    - `balance` integer
    - `spendable` boolean
    - `purchaseEligible` boolean
    - `autoReloadEligible` boolean
  - `warnings` string[], required

## Other responses

- `401`: Authentication required.

---

[API](https://skmtc.dev/aetherya/apis/aetherya-api.md) · [All operations](https://skmtc.dev/aetherya/apis/aetherya-api/llms.txt) · [OpenAPI document](https://skmtc.dev/aetherya/apis/aetherya-api/revisions/afa076131ee1?raw)