To ensure API stability and fair usage, the JAVIS API enforces rate limits on requests. If a client exceeds the limit, the API responds with an appropriate error message.

🔗 Rate Limits

JAVIS API follows industry-standard rate limits:

API Type	Rate Limit
General API Requests	1,000 requests per minute
High-Impact Endpoints (e.g., Order Creation, Payment Processing)	100 requests per minute
Bulk Data Requests (Reports, Exports)	10 requests per minute

⚠️
Note: Rate limits apply per API key. Exceeding these limits results in an error response.

❌ Handling Rate Limit Exceedance (`429 Too Many Requests`)

If a client exceeds the allocated rate limit, the API returns:

{
  "status": "error",
  "error": {
    "code": 429,
    "message": "Rate limit exceeded. Try again after 30 seconds."
  }
}

🔄 Best Practices for Handling Rate Limits

To prevent disruptions, follow these best practices:

✅ Implement Exponential Backoff

If a request fails due to rate limits:
1. Wait 1 second, retry.
2. If it fails, wait 2 seconds, retry.
3. If it still fails, wait 4 seconds, retry.
4. Continue doubling the wait time up to 5 retries.

✅ Optimize API Usage

Avoid unnecessary polling; use cached responses where possible.
Batch multiple actions into a single request where applicable.

✅ Monitor API Usage

Track request patterns and adjust API calls to avoid hitting limits.

📩 Requesting Higher Rate Limits

If you require higher rate limits for business-critical operations, contact support with a justification for your request.

📧 Support Email: care@javis.ai