Rate Limits Reference¶

Learn about Voucher API rate limits and how to handle them.

Rate Limit Headers¶

All API responses include rate limit headers:

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 999
X-RateLimit-Reset: 1710936000

Default Limits¶

Endpoint-Specific Limits¶

Rate Limit Errors¶

When rate limit is exceeded:

{
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Too many requests",
    "details": {
      "limit": 100,
      "reset_at": "2024-03-20T10:01:00Z"
    }
  }
}

Best Practices¶

1. Request Management
2. Implement request queuing
3. Use batch operations

4. Cache responses

5. Error Handling

6. Implement exponential backoff
7. Monitor rate limit headers

8. Handle retries gracefully

9. Performance

10. Optimize request patterns
11. Use appropriate endpoints
12. Monitor usage patterns

Next Steps¶

• Review error handling
• Check voucher endpoints
• See webhook events