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

# Plans & Usage

> Subscription tiers, operation limits, what counts as an operation, and how to track usage.

# Plans & Usage

All plans include full access to the web app, REST API, MCP, and all AI model tiers. Plans differ only by operation volume.

## Pricing tiers

| Plan           | Price   | Included operations | Overage                                            |
| -------------- | ------- | ------------------- | -------------------------------------------------- |
| **Free**       | \$0/mo  | 500/mo              | Pauses at limit (429 error)                        |
| **Plus**       | \$20/mo | 2,000/mo            | Pay-as-you-go up to 4,000 total. Max bill \$50/mo. |
| **Pro**        | \$99/mo | 10,000/mo           | Pay-as-you-go, no cap                              |
| **Enterprise** | Custom  | Custom              | Custom                                             |

## What counts as an operation

AI actions that modify, analyze, or search documents count as operations:

* Editing a document section
* A multi-section edit in one request (e.g. "tighten every section") counts as **one** operation; very large requests count one operation per 25 sections edited
* Creating new content
* Opening a brand-new document via chat ("put this in a new document")
* Deleting content
* Searching the document
* Searching attachments
* Analyzing document context
* Loading a template

**Not counted:** Opening the editor, typing, formatting text, viewing sessions, basic conversations without document actions — and review-mode changes you **deny** are not billed. Edit requests that **fail** bill 0, and so does an edit request the document **already satisfies** (the AI replies honestly that nothing needed changing instead of charging you for a rewrite).

## Check your usage

### In the app

Click your avatar to see your usage bar, operations count, and remaining operations.

### In API responses

Every chat response includes a `usage` object:

```json theme={null}
{
  "usage": {
    "monthly_used": 42,
    "monthly_limit": 500,
    "monthly_remaining": 458,
    "was_billable": true,
    "ops_charged": 1,
    "quota_exhausted": false,
    "subscription_tier": "free"
  }
}
```

`ops_charged` is how many operations the request billed — a single request can bill more than one (one operation per 25 sections edited), so `monthly_used` can increase by more than 1 between responses. `quota_exhausted` becomes `true` when you have reached your plan's operation limit with no remaining balance; the current request still completes, but further billable requests pause until you upgrade or your billing cycle resets.

<Note>
  **Reading usage from an API key:** the `/v1/users/me/usage` and `/v1/users/me/limits` endpoints belong to the web-app account surface and accept web-app session tokens only — they reject `sk_` / `lce_` API keys with a `401`. From an API-key context, read usage straight off the `usage` block returned in **every** `/v1/chat` and `/v1/chat/async` response (shown above) and the SSE `usage` event — no separate call needed. View usage in the browser at [use.superdocs.app](https://use.superdocs.app) → Settings.
</Note>

## Promo codes & credits

If you have a promo code, redeem it for operation credits. Credits are drawn down **before** your plan's monthly allowance, so they stretch your included operations further.

```bash theme={null}
curl -X POST https://api.superdocs.app/v1/promo/redeem \
  -H "Authorization: Bearer sk_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"code": "YOUR_CODE"}'
```

Redemption is for **personal accounts** — authenticate with a personal API key (`sk_`) or a logged-in session. Organization keys (`lce_`) can't redeem codes. Your account email must be verified, and each code can be redeemed **once per account**.

Check your active credits:

```bash theme={null}
curl https://api.superdocs.app/v1/users/me/promotions \
  -H "Authorization: Bearer sk_YOUR_API_KEY"
```

This returns your active promotions and their remaining credit balance.

## Monthly reset

Operations reset at the start of each billing cycle. Free plans reset monthly from account creation.