Overview
The Onefile API enforces a rate limit to ensure stable and reliable performance for all customers. If your integration exceeds this limit, requests will temporarily be blocked.
API Rate Limit
- Maximum: 300 API calls per minute
- If this limit is reached, the API will return a 429 – Too Many Requests error.
How to Avoid Hitting the Limit
If your system is regularly reaching the rate limit, consider the following:
- Use paged searches to retrieve larger batches of data in a single request.
This is more efficient than making multiple small calls. - Cache data when appropriate instead of re‑requesting unchanged values.
- Stagger bulk processing jobs to avoid rapid bursts of requests.
Tips & Notes
- A 429 error indicates you must wait before retrying your request.
- If you frequently reach the limit, review your API logic to reduce unnecessary calls.
Terminology
Terminology used in this article may differ depending on your Centre.
Related Articles
Need Help?
If you need assistance or have questions about API usage, please contact Onefile Support or your internal technical team.