Limits
Request, storage, and payload limits for the public API.
vprinter applies limits at three layers: client IP, workspace request rate, and workspace usage.
Request Rate
All requests are subject to a per-IP limit before workspace-level authorization runs.
| Limit | Value |
|---|---|
| Per IP | 200 requests per 10 seconds |
Workspace endpoints also apply a per-workspace rate limit based on the workspace tier.
| Limit |
|---|
| 600 requests per minute |
When a request exceeds a rate limit, the API returns 429 RATE_LIMIT_EXCEEDED.
Stored Prints
Stored print count is enforced per workspace.
| Limit |
|---|
| 100 total stored prints |
When a workspace exceeds its stored-print quota, print creation is rejected.
Print Payload Size
Each raw ESC/POS payload is limited to 1 MiB. This applies to both binary uploads and JSON base64 uploads.
Oversized print data returns 413 PRINT_DATA_TOO_LARGE.