API Rate Limits

Understand and work within StartupVision API rate limits.

Rate Limit Tiers

Enterprise Standard

• 100 requests per minute
• 10,000 requests per day
• 5 concurrent validation requests

Enterprise Plus

• 500 requests per minute
• 50,000 requests per day
• 20 concurrent validation requests

Rate Limit Headers

Every API response includes rate limit information:

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 95
X-RateLimit-Reset: 1705320000

Handling Rate Limits

When you exceed rate limits, you'll receive:

HTTP 429 Too Many Requests

{
  "success": false,
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded. Try again in 45 seconds.",
    "retryAfter": 45
  }
}

Best Practices

Implement Exponential Backoff

async function requestWithRetry(fn, maxRetries = 3) {
  for (let i = 0; i < maxRetries; i++) {
    try {
      return await fn();
    } catch (error) {
      if (error.status === 429) {
        const delay = Math.pow(2, i) * 1000;
        await sleep(delay);
      } else {
        throw error;
      }
    }
  }
  throw new Error('Max retries exceeded');
}

Cache Responses

Store and reuse responses when appropriate to reduce API calls.

Batch Requests

Use bulk endpoints when available to reduce request count.

Monitor Usage

Track your usage with the X-RateLimit-Remaining header.

Increasing Limits

Need higher limits? Contact your account manager or support.