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.