Rate Limits

Phase 2

This documentation is a preview. The API is currently in development.

Default limits

Plan	Requests per minute	Requests per day
Standard	60	10,000
Enterprise	300	100,000

Rate limit headers

Every API response includes rate limit information in the headers:

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 45
X-RateLimit-Reset: 1679000000

Header	Description
X-RateLimit-Limit	Maximum requests allowed in the current window
X-RateLimit-Remaining	Requests remaining in the current window
X-RateLimit-Reset	Unix timestamp when the rate limit resets

Exceeding limits

If you exceed the rate limit, you'll receive a 429 Too Many Requests response:

{
  "success": false,
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Rate limit exceeded. Retry after 30 seconds.",
    "retry_after": 30
  }
}

Best practices

• Cache responses where data doesn't change frequently (locations, profiles)
• Use webhooks for real-time data instead of polling the API
• Batch operations where the API supports it
• Implement exponential backoff for retries when rate limited
• Monitor your usage through the rate limit headers