Rate Limiting
Bootspring API implements rate limiting to ensure fair usage and system stability.
Rate Limits by Plan#
| Plan | Requests/Minute | Requests/Hour | Requests/Day |
|---|---|---|---|
| Free | 20 | 100 | 1,000 |
| Pro | 60 | 1,000 | 10,000 |
| Team | 120 | 5,000 | 50,000 |
| Enterprise | Custom | Custom | Custom |
Rate Limit Headers#
Every API response includes rate limit information:
Loading code block...
Header Descriptions#
| Header | Description |
|---|---|
X-RateLimit-Limit | Maximum requests allowed in the window |
X-RateLimit-Remaining | Requests remaining in current window |
X-RateLimit-Reset | Unix timestamp when the limit resets |
X-RateLimit-Policy | Rate limit policy (requests;w=window_seconds) |
Rate Limit Exceeded#
When you exceed the rate limit, you'll receive a 429 Too Many Requests response:
Loading code block...
Endpoint-Specific Limits#
Some endpoints have additional rate limits:
| Endpoint | Limit | Window |
|---|---|---|
POST /auth/device/code | 5 | 1 minute |
POST /auth/device/token | 20 | 1 minute |
POST /v1/track | 1000 | 1 minute |
GET /v1/agents | 100 | 1 minute |
Handling Rate Limits#
JavaScript/TypeScript#
Loading code block...
Exponential Backoff#
Loading code block...
Python#
Loading code block...
Monitoring Rate Limits#
Track Remaining Requests#
Loading code block...
Proactive Rate Limiting#
Loading code block...
Best Practices#
1. Cache Responses#
Loading code block...
2. Batch Requests#
Loading code block...
3. Use Webhooks#
Instead of polling, configure webhooks for real-time updates:
Loading code block...
4. Implement Request Queuing#
Loading code block...
Increasing Rate Limits#
Upgrade Your Plan#
Higher tier plans include increased rate limits. Visit Pricing to upgrade.
Enterprise Custom Limits#
For enterprise customers, we offer custom rate limits based on your needs. Contact sales@bootspring.dev.
Burst Allowance#
All plans include a burst allowance of 2x the per-minute limit for short spikes.