Developer Docs

Rate Limiting

API requests are rate-limited based on your API key tier.

Rate Limit Tiers

API rate limits are based on your API key's tier. Each tier defines a maximum number of requests per minute.

Tier Requests / Minute Use Case
standard 120 Default for all API keys. Suitable for most integrations.
high 600 For high-throughput integrations and automation.
enterprise 3,000 For enterprise-scale applications with heavy API usage.

Rate Limit Headers

Every API response includes headers to help you track your rate limit usage:

Header Description
X-RateLimit-Limit Maximum requests allowed per minute for your tier.
X-RateLimit-Remaining Number of requests remaining in the current window.
X-RateLimit-Reset Unix timestamp when the rate limit window resets.

Exceeding the Rate Limit

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

{
  "message": "Too many requests. Please try again in 45 seconds.",
  "retry_after": 45
}

Best Practices

  • Implement exponential backoff when you receive a 429 response.
  • Cache frequent read responses to reduce API calls.
  • Use the X-RateLimit-Remaining header to proactively throttle requests.
  • Contact support to upgrade your tier if you consistently hit limits.
Start Today

Stop Losing Customers
to Slow Responses

Every minute you wait is revenue walking out the door. Join hundreds of businesses who transformed their customer communication with ChatOn.

50%
Faster Response
24/7
AI Support
40%
Higher Conversion
No credit card required
Setup in 5 minutes
Cancel anytime

βœ“ 30-day money-back guarantee

πŸͺ We use cookies

We use cookies and similar technologies to improve your experience, analyze traffic, and personalize content. By clicking "Accept All", you consent to our use of cookies. Privacy Policy & Cookie Policy.

Cookie Preferences

Choose which cookies you want to allow. Essential cookies are always required for the website to function.

Essential Cookies

Required for the website to function. Cannot be disabled.

Always On

Analytics Cookies

Help us understand how visitors interact with our website by collecting anonymous data.

Marketing Cookies

Used to track visitors across websites to display relevant advertisements.

βœ… Preferences saved!