Rate Limits
Vouchley applies per-key rate limits to protect the service and ensure fair usage across all customers.
Rate limits by plan
Limits are enforced per API key, per minute. The tier is determined by your current credit balance:
| Tier | Requests / minute | Condition |
|---|---|---|
| Free | 100 | Credit balance ≤ 100 |
| Paid | 600 | Credit balance > 100 |
How it works
Vouchley uses a fixed-window rate limiter. Each API key gets a per-minute counter that resets at the start of every calendar minute. If you exceed the limit, subsequent requests in that window receive a 429 Too Many Requests response.
Handling 429 responses
When you receive a 429 response, back off and retry after a short delay. The simplest strategy is exponential backoff:
- Wait 1 second, then retry.
- If still 429, wait 2 seconds, then retry.
- Continue doubling up to a maximum of 30 seconds.
The 429 response body contains: {"detail": "Rate limit exceeded. Slow down and try again."}