Rate Limits
The Enconvert API enforces rate limits to ensure fair usage and service stability. Limits vary by key type and subscription tier.
Private Key Rate Limits
Private keys (sk_) are intended for server-to-server integrations and have higher rate limits.
| Tier | Per Minute | Per Hour | Per Day |
|---|---|---|---|
| Free | 60 | 1,000 | 10,000 |
| Basic | 300 | 5,000 | 50,000 |
| Pro | 1,000 | 20,000 | 200,000 |
Public Key Rate Limits
Public keys (pk_) and their associated JWT tokens have lower rate limits to reflect their client-side usage pattern.
| Tier | Per Minute | Per Hour | Per Day |
|---|---|---|---|
| Free | 10 | 100 | 1,000 |
| Basic | 60 | 1,000 | 10,000 |
| Pro | 300 | 5,000 | 50,000 |
Rate Limit Response
When a rate limit is exceeded, the API returns a 429 Too Many Requests status:
{
"detail": "Rate limit exceeded. Please try again later."
}
If you receive this response, wait before retrying. Implement exponential backoff in your application to handle rate limits gracefully.
Monthly Conversion Limits
In addition to per-minute, per-hour, and per-day rate limits, the API enforces monthly conversion caps based on your subscription tier:
| Tier | Monthly Limit |
|---|---|
| Free | 20 conversions per month |
| Basic | Unlimited |
| Pro | Unlimited |
Monthly limits reset on the 1st of each month at midnight UTC. When the limit is exceeded, the API returns a 402 Payment Required status:
{
"detail": "Monthly conversion limit reached. Please upgrade your plan."
}
Upgrade to Basic or Pro for unlimited monthly conversions.