API Limits and Billing
Business subscription, credits, API key, and rate-limit rules
Business subscription
An active Business Monthly or Business Yearly subscription unlocks API access. Credit packs provide additional credits only while Business API access is active.
Credits
- One generated PDF page consumes one credit.
- The API checks the balance before rendering and charges only after successful PDF generation.
- Validation and rendering errors do not consume credits.
- Concurrent requests share the same credit balance. Keep enough credits for all requests that may be running at the same time.
API keys
Each Business account can keep up to five active API keys.
Rate limit
Each key can make up to 100 requests per minute. This is a service guard rather than a guaranteed throughput level. A limited request returns HTTP 429, RATE_LIMIT_EXCEEDED, and a Retry-After header.
Timeouts
PDF generation is configured for a maximum server processing time of 60 seconds, although a network or hosting platform may end a request sooner. Keep templates and remote image assets reasonably sized. Use the response requestId when reporting a timeout or generation failure.
Retries
- Do not retry
400,401,402,403,404, or422responses until the request or account state has been corrected. - For
429, wait for the number of seconds inRetry-Afterbefore trying again. - For
500or503, retry with exponential backoff and a small amount of random jitter. - The API does not currently support idempotency keys. If a request may have completed but its response was lost, retrying can generate and charge for another PDF.
API Errors
HTTP statuses and stable error codes returned by the Business API
SheetsToLabels Troubleshooting — Fix Common Errors & Issues
Solve the most common SheetsToLabels problems: blank PDF output, data columns not appearing, merge fields showing raw text, images not loading, and label misalignment when printing.