Document Stack
Document Stack
Docs

Usage & Quotas

Monitor your API usage, understand quota limits, and track PDF generation.

Understanding Quotas

Every Document Stack plan includes a monthly quota for PDF generations. A single "generation" counts as one API call to the /api/v1/generate endpoint that successfully produces a PDF.

  • Free — 100 generations / month
  • Pro — 10,000 generations / month
  • Enterprise — Unlimited
Failed API requests (validation errors, authentication failures) do not count against your quota. Only successful PDF generations are counted.

Checking Your Usage

You can monitor your current usage in two ways:

Dashboard

Your organization dashboard shows a usage summary with the current month's generation count, remaining quota, and a chart of daily usage over time.

API Response Headers

Every API response includes usage information in the headers:

http
X-RateLimit-Limit: 10000
X-RateLimit-Remaining: 7842
X-RateLimit-Reset: 2026-03-01T00:00:00Z
  • X-RateLimit-Limit — Your monthly quota
  • X-RateLimit-Remaining — Generations remaining this period
  • X-RateLimit-Reset — When the quota resets

Quota Reset

Quotas reset on the first day of each calendar month at midnight UTC. Unused generations do not carry over to the next month.

Exceeding Your Quota

When you hit your monthly quota:

  • API calls to /api/v1/generate will return 429 Too Many Requests
  • The response includes a Retry-After header with the reset date
  • Template editing and previewing in the Studio still works
  • Existing generated PDFs remain accessible
JSON
{
  "success": false,
  "error": "Monthly generation quota exceeded. Resets on 2026-03-01T00:00:00Z. Upgrade your plan for higher limits."
}

Usage Notifications

Document Stack sends email notifications to organization owners and admins at:

  • 80% usage — Warning that you're approaching your limit
  • 100% usage — Quota exhausted, API generation paused

Per-Project Usage

The dashboard breaks down usage by project, so you can see which projects consume the most generations. This helps you identify:

  • Which projects drive the most volume
  • Unexpected usage spikes
  • Whether to upgrade or optimize

Optimizing Usage

  • Preview before generating — Use the editor preview instead of API calls during development
  • Cache PDFs — Store generated PDFs instead of regenerating the same document
  • Batch wisely — Combine multiple items into a single multi-page document when possible
  • Use test keys — Test API keys generate lower-resolution PDFs that don't count toward your quota (Pro plan)

Next Steps

Previous

Billing & Plans

Next

Account Settings