Skip to main content
Sunbird AI enforces rate limits to ensure fair usage and system stability. Limits are applied per account based on the type of plan you are on.

​
Account Tiers

Rate limits are determined by the account_type in your authentication token:

Free Tier

Designed for testing and development. Usage is limited to prevent abuse.

Professional

Higher rate limits suitable for production applications.

Enterprise

Custom rate limits tailored to high-volume needs. Contact sales for details.

​
Handling Rate Limits

When you exceed your rate limit, the API will return a 429 Too Many Requests status code.

​
Best Practices

1

Check Headers

Inspect the Retry-After header in the 429 response to know how long to wait.
2

Exponential Backoff

Implement an exponential backoff strategy. If a request fails, wait for a short period (e.g., 1s), then retry. If it fails again, double the wait time (2s, 4s, etc.).
3

Add Jitter

Add random “jitter” to your wait times to prevent all your clients from retrying at the exact same millisecond.