Rate Limits

Rate limits protect API performance and ensure fair usage. Limits vary by plan tier and are calculated per organization per minute.

Rate Limit Tiers

Rate Limit Headers

Every API response includes headers showing your current rate limit status. Monitor these to avoid hitting limits.

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 87
X-RateLimit-Reset: 1645123456

Handling Rate Limits

When you exceed the rate limit, the API returns 429 Too Many Requests with a Retry-After header indicating when to retry.

async function apiRequest(url, options) {
  const response = await fetch(url, options);
  
  if (response.status === 429) {
    const retryAfter = response.headers.get('Retry-After');
    await new Promise(resolve => setTimeout(resolve, retryAfter * 1000));
    return apiRequest(url, options); // Retry
  }
  
  return response;
}

Best Practices

Cache responses when possible. Use batch endpoints to reduce request count. Monitor X-RateLimit-Remaining header and throttle requests proactively. Contact support for higher limits if needed.