Requests are throttled per organization to ensure fair usage and system stability.
Default Limit: 100 requests per hour
Rate limits are configurable per organization. Contact your administrator if you need higher limits.
- Rate limits are enforced per API key
- The limit resets every hour (rolling window)
- Both successful and failed requests count toward your limit
Every API response includes headers showing your current rate limit status:
| Header | Description |
|---|---|
X-RateLimit-Limit | Maximum requests allowed per hour |
X-RateLimit-Remaining | Requests remaining in current window |
X-RateLimit-Reset | Unix timestamp when the limit resets |
Example:
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 87
X-RateLimit-Reset: 1672531200When you exceed your rate limit, the API returns 429 Too Many Requests:
{
"success": false,
"errors": {
"__all__": ["Rate limit exceeded. Please try again later."]
}
}The response includes a Retry-After header indicating how many seconds to wait.
Optimize Your Usage:
- Monitor
X-RateLimit-Remainingheader - Implement exponential backoff for retries
- Cache responses for master data (accounts, items, etc.)
- Distribute requests evenly throughout the hour
If you need higher rate limits:
- Analyze your current usage patterns
- Optimize to reduce unnecessary requests
- Contact your administrator with justification
- Consider using multiple API keys for different services
Next: Learn about Pagination →