Using the API
Limits
Plan limits
| Limit | Free | Pro and trial | Developer | Business |
|---|
| Upload size | 10 MB | 100 MB | 250 MB | 250 MB |
| Pages per job | 25 | 500 | 2,000 | 5,000 |
| Maximum DPI | 150 | 600 | 600 | 600 |
| Jobs at the same time | 1 | 3 | 10 | 25 |
| Credits per month | 25 | 1,000 (trial: 100 once) | 5,000 | 20,000 |
GET /v1/usage returns the limits that apply to your workspace right now.
Limits on every plan
| Limit | Value |
|---|
| Size of one page | 100 megapixels at the chosen DPI |
| Job submissions | 60 per minute per API key |
| API keys | 25 active per workspace |
| Webhook endpoints | 10 per workspace |
| Options JSON | 16 KB |
| Sign-ups | 5 per hour per IP address |
| Sign-in attempts | 5 per 10 minutes per email address, 20 per 10 minutes per IP address |
When you hit a limit
| Limit | You get |
|---|
| Upload size | 413 file_too_large |
| DPI above your plan | 403 plan_limit_exceeded |
| Too many jobs at once | 429 too_many_active_jobs |
| Too many requests | 429 rate_limited with a Retry-After header |
| Pages per job, or a page too large | The job fails with limit_exceeded, because the PDF has to be opened first |
| Not enough credits | The job fails with insufficient_credits |
RasterNivo