Skip to main content

​
Rate Limits

SuperDocs uses operation-based limits, not request-rate limits. Each AI action that modifies, analyzes, or searches a document counts as one operation.

​
Limits by tier

PlanIncluded operationsAt the limitMax monthly bill
Free500/moPauses (429 error)$0
Plus2,000/moOverage at $0.015/op, up to 4,000 total$50
Pro10,000/moOverage at $0.015/op, no capVaries
EnterpriseCustomCustomCustom

​
Handling 429 responses

When you hit the limit on the free plan, the API returns: 
HTTP/1.1 429 Too Many Requests
X-Usage-Limit: 500
X-Usage-Used: 500
X-Usage-Remaining: 0

{"detail": "Monthly operation limit (500) reached. Upgrade your plan for more operations."}
Best practices:
  • Check the usage object in chat responses to track remaining operations
  • Call GET /v1/users/me/limits before critical workflows
  • Upgrade to a paid plan for uninterrupted access

​
Check remaining operations

​
From API responses

Every chat response includes usage data: 
{
  "usage": {
    "monthly_used": 480,
    "monthly_limit": 500,
    "monthly_remaining": 20,
    "was_billable": true,
    "subscription_tier": "free"
  }
}

​
Via dedicated endpoint

curl https://api.superdocs.app/v1/users/me/limits \
  -H "Authorization: Bearer sk_YOUR_API_KEY"

​
Monthly reset

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