---
title: "Read this account's remaining allowance"
method: GET
path: "/usage"
---

# Read this account's remaining allowance

`GET /usage`

## Request

- Base URL: `https://epublys.com/v1`
- URL: `https://epublys.com/v1/usage`
- Auth: HTTP bearer

Daily operations and AI-cover quota for the account that owns the API key. Not metered and never counted against the daily allowance, so a caller can check before spending. The daily allowance is per ACCOUNT and shared by every key and by both REST and MCP.

## Response `200`

Current allowance

- object
  - `success` boolean
  - `plan` string
  - `account` string
  - `dailyOps` object
  - `cover` object

## Other responses

- `400`: Invalid input — human message in `error`, machine category in `code`
- `401`: Missing or invalid API key
- `413`: Upload exceeds the per-request total cap
- `429`: Rate limited
- `500`: Processing failure

---

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