Rate Limits

PixDoc uses monthly render caps based on your plan. There are no per-second rate limits. You can burst as many requests as you need, up to your monthly allocation.

Plan Limits

Plan	Included Renders	Overage	Templates	Log Retention
Free	100/month	Not available	3	7 days
Starter	5,000/month	$0.01/render	25	30 days
Pro	25,000/month	$0.01/render	Unlimited	90 days
Business	100,000/month	$0.01/render	Unlimited	365 days

Overage Billing

Paid plans (Starter, Pro, Business) support overage billing. When you exceed your included monthly renders, additional renders are billed at $0.01 per render.

Overage renders are never blocked. Your API calls continue working
Overage charges appear on your next monthly invoice
The X-Renders-Remaining header returns 0 when in overage
The X-Overage-Renders header shows how many overage renders you've used
You can monitor your usage in the dashboard at any time

The Free plan does not support overage billing. Free users are blocked at 100 renders per month and must upgrade to continue.

How Counting Works

Each successful render counts as one render toward your monthly limit:

PDF renders, screenshots, and OG images all count equally
Failed renders do not count against your limit
Cached OG images (cache hits) do not count. Only the initial render that populates the cache is counted

Use OG image caching to your advantage. Once an OG image is cached, subsequent requests for the same template and variable combination are served from cache at no render cost.

Monthly Reset

Your render count resets on the 1st of each month at midnight UTC. Unused renders do not roll over to the next month.

Response Headers

Every successful render response includes a header showing your remaining allocation:

X-Renders-Remaining: 4832

Monitor this header to track your usage programmatically and trigger alerts or plan upgrades before you hit the limit.

Exceeding Your Limit

Free plan: When you reach 100 renders, additional requests return a 429 error until your limit resets on the 1st of the next month, or you upgrade to a paid plan.

Paid plans: When you exceed your included renders, additional renders continue working and are billed at $0.01 per render. You are never blocked.

{
  "error": {
    "code": "RATE_LIMITED",
    "message": "Monthly render limit exceeded",
    "details": {
      "plan": "free",
      "limit": 100,
      "resetDate": "2026-04-01T00:00:00Z"
    }
  }
}

The 429 error above only applies to the Free plan. Paid plans allow unlimited overage renders at $0.01 each.

PixDoc does not currently enforce per-second rate limits. You can send requests as fast as your application needs. If per-second limits are introduced in the future, they will be communicated through the response headers and documentation ahead of enforcement.

Upgrading Plans

To increase your render allocation:

Go to Dashboard > Settings and select your desired plan
The upgrade takes effect immediately
Your new monthly limit applies to the current billing period. Your existing render count is preserved, and you gain access to the higher cap right away

If you need limits beyond the Business plan, contact sales for a custom arrangement.