🔌 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

EndpointLimit
/auth/login10 requests/minute
/auth/register5 requests/hour
/guests/import10 requests/hour
All other endpoints100 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: 1640000000

Handling 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

© 2025 FreePas. All rights reserved.