Rate Limits
To prevent abuse and ensure the stability and reliability of our service, we have implemented two types of rate limits for API usage. These limits help balance the load on our servers and provide a fair usage policy for all users.
Request Rate Limit
Limit: 60 requests per minute
Description: This limit controls the number of API requests you can make within a one-minute time window. It operates on a sliding window basis, meaning the window moves forward with each passing moment rather than resetting at fixed intervals.
How It Works:
- Every time you make a request, it's added to your usage count for the past minute.
- If you reach 60 requests within any 60-second period, subsequent requests will be denied until your request count falls below the limit.
- This approach allows for smoother traffic management and prevents sudden spikes in usage.
Concurrent Request Limit
Limit: 3 concurrent requests
Description: This limit controls the number of concurrent API requests that can be accepted and processed simultaneously by the server. It helps manage server load and prevents too many simultaneous operations.
How It Works:
- You can have up to 3 API requests being processed at the same time.
- If you exceed this limit, additional requests will be rejected until one of the ongoing requests completes.
Asynchronous Endpoint
- For the asynchronous endpoint, this limit applies to the number of conversion requests being accepted concurrently, but the actual conversions may be processed in parallel across multiple machines once accepted.
- This means you can submit as many asynchronous conversion requests as needed, but no more than 3 will be accepted simultaneously at the request level.
Limits in Response Headers
Rate limit details are returned in the headers of every API response to help you monitor your usage in real time. The following headers are included:
| Header Name | Description |
|---|---|
x-pdfbolt-ratelimit-limit-day | Total allowed requests per day. |
x-pdfbolt-ratelimit-limit-hour | Total allowed requests per hour. |
x-pdfbolt-ratelimit-limit-minute | Total allowed requests per minute. |
x-pdfbolt-ratelimit-remaining-day | Remaining allowed requests in the current day. |
x-pdfbolt-ratelimit-remaining-hour | Remaining allowed requests in the current hour. |
x-pdfbolt-ratelimit-remaining-minute | Remaining allowed requests in the current minute. |
Need Higher Limits?
If you need to increase these limits to support your application's requirements, please contact us. We are happy to discuss your needs and adjust the limits accordingly to accommodate your usage.
Unverified Accounts
Unverified accounts are subject to different limitations. For detailed information, refer to the Unverified Accounts Limitations section.