Rate Limiting

Understand request rate limits and how to handle throttling.

The API enforces rate limits to ensure fair usage and platform stability.

Default limits

Scope	Limit	Window
Global (all endpoints)	60 requests	60 seconds
Auth endpoints (`/v1/auth/register`, `/v1/auth/login`)	5 requests	60 seconds

Rate limits are applied per IP address.

Handling rate limits

When you exceed the rate limit, the API returns a 429 Too Many Requests response:

{
  "error": {
    "type": "rate_limit_error",
    "code": "too_many_requests",
    "message": "Rate limit exceeded. Try again later."
  },
  "request_id": "req_abc123def456"
}

We recommend implementing exponential backoff in your client to handle rate limit responses gracefully.

Response

{
  "error": {
    "type": "rate_limit_error",
    "code": "too_many_requests",
    "message": "Rate limit exceeded. Try again later."
  },
  "request_id": "req_abc123def456"
}