Rate Limits & Quotas

Rate limits

All API endpoints are rate-limited to 60 requests per minute per authenticated user. This limit applies across all endpoints combined.

Response headers

Every API response includes headers showing your current rate limit status:

• X-RateLimit-Limit — maximum requests allowed per minute (60)
• X-RateLimit-Remaining — requests remaining in the current window

Exceeding the limit

If you exceed the rate limit, the API returns a 429 Too Many Requests response. Wait until the next minute window before retrying.

{
  "message": "Too Many Requests."
}

Monthly quotas

Each plan includes a monthly quota of PDF generations. Quotas reset on your billing renewal date each month. Unused generations do not roll over.

Reaching your quota

Generation stops once the monthly quota is reached, on every plan: the API answers 429 Too Many Requests until the next period. There is no pay-as-you-go overage — upgrade the plan if you need more headroom.

Quota notifications

You receive email notifications when your usage reaches:

• 80% of your monthly quota
• 100% of your monthly quota

Monitoring usage

You can track your usage in two ways:

• Dashboard — view real-time usage statistics in your dashboard
• API — call GET /api/v1/usage for programmatic access (see Templates API)

Every PDF generation response also includes a usage object with your current consumption.

Best practices

• Implement retry logic with exponential backoff for 429 responses
• Cache generated PDFs on your side when the same document is requested multiple times
• Monitor your usage via the API or dashboard to anticipate quota limits
• Use the url output format to avoid transferring large base64 payloads