🔌 API Reference
Rate Limiting
API rate limits and best practices
Rate Limiting
API requests are rate-limited to ensure fair usage and platform stability.
Rate Limits by Endpoint
| Endpoint | Limit |
|---|---|
/auth/login | 10 requests/minute |
/auth/register | 5 requests/hour |
/guests/import | 10 requests/hour |
| All other endpoints | 100 requests/minute |
Rate Limit Headers
All API responses include rate limit information in headers:
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 95
X-RateLimit-Reset: 1640000000Handling Rate Limits
When you exceed the rate limit, the API returns a 429 Too Many Requests response:
{
"error": "rate_limit_exceeded",
"message": "Too many requests. Please try again later.",
"retry_after": 60
}Best Practices
- Implement exponential backoff when receiving 429 responses
- Cache responses where appropriate
- Use webhooks instead of polling when possible
- Batch operations when available
- Monitor rate limit headers proactively