---
title: "Account allowances"
method: GET
path: "/usage"
---

# Account allowances

`GET /usage`

## Request

- Base URL: `https://promvia.app/api/v1`
- URL: `https://promvia.app/api/v1/usage`
- Auth: HTTP bearer

Every allowance on the account: API requests; fullChecks.left, the check budget — full checks (one question on every engine in fullChecks.engines) left on demand this month; fullChecks.breakdown, where the month went in the same full checks (weekly deep checks, daily checks, held for later automatic checks, started by you, automatic extras by lane, left, and the total they add up to; null on a legacy period); citationCalls.budgetModelVersion, the ledger it was read from — on versions 1 and 2 citationCalls also carries the scheduled and on-demand buckets with purchased top-ups in provider calls (the deprecated reserved/made are always calls), on version 3 those internal quantities are omitted and limit is null; engines.selected, the engines the account's scheduled checks run on (its own choice, or the plan default), engines.daily, the ones among them on the frequent check this month; engines.sites, each site's real interval for that check in days (checkedEveryDays; 7 means only the weekly check); expansion packs; sites; tracked questions; generation budget; white-label and the founding term. The same ledgers the product debits.

## Response `200`

Account allowances

## Other responses

- `401`: Missing/invalid API key.
- `402`: API access requires a Pro or Agency plan.
- `403`: The key's account holds a seat in another workspace — API keys are owner credentials.
- `429`: Per-minute rate limit or the monthly request pool exceeded. A monthly-pool 429 names the limit and reset date in the body and X-RateLimit headers; the burst 429 just asks you to retry shortly.

---

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