SmartSuite places limits on its REST API to ensure the platform remains secure and high-performing for all users. These limits are categorized as:
Number of Requests: Each subscription plan has a monthly limit on API requests. Exceeding this limit slows request rates, and further overages result in denied requests.
Request Rate: Limits the speed of requests per second per user, regardless of the subscription plan.
Plan Availability | All plan types with varying limitations |
Permissions | Administrators |
API Limits by Plan
Monthly Request Limits
Plan | Full-Speed Requests | Maximum Requests (at 2/sec) |
Free Plan | 1,000 | N/A |
Team Plan | 5,000 | 10,000 |
Professional | 100,000 | 200,000 |
Enterprise | 500,000 | 1,000,000 |
Request Rate Limits
Standard Rate: 5 requests per second per user (while under your plan’s monthly limit).
Overage Rate: 2 requests per second per user (after exceeding the monthly limit).
Exceeding 200% of the monthly request limit results in all additional requests being denied until the following month.
Why Are API Requests Limited?
API rate limits protect the platform’s speed, scalability, and security by:
Preventing service interruptions caused by high traffic or misuse.
Guarding against denial of service (DoS) attacks.
How Throttling Works
API usage is metered at the workspace level, with independent limits for authenticated users:
Each user can make 5 or 2 requests per second, depending on the workspace’s status relative to the monthly request limit.
Our API counts request per-second ("clock" second) basis, so 4:50:01 and 4:50:02 will each allow 5 requests.
All users’ requests count toward the overall workspace limit.
For example:
User 1 and User 2 can each make 5 requests per second simultaneously, provided the workspace is under its limit.
All requests from User 1 and User 2 contribute to the shared monthly quota.
Handling API Overages
When you exceed your monthly API request limit:
Request speed is reduced to 2 per second per user.
After reaching 200% of the monthly limit, all additional requests will be denied (HTTP 429 status code).
To optimize high-volume usage, consider implementing a caching proxy.
Key Notes
While under the monthly limit, exceeding the rate of 5 requests per second results in a 429 error code and a 30-second wait before retrying.
Increased request limits are not currently available.
For more details about API Request limits and overages please see this article.