API Documentation
Rate Limiting
v2 Rate Limits by Plan
The v2 API uses API Key authentication. Rate limits and monthly quotas depend on your subscription tier. Unauthenticated v2 requests will be rejected.
| Plan | Rate Limit | Monthly API Calls | Monthly Links | Monthly QR Codes |
|---|---|---|---|---|
| FREE | 60/min | 2,000 | 35 | 35 |
| HOBBY | 300/min | 25,000 | 350 | 350 |
| INDIE | 1,000/min | 150,000 | 1,800 | 1,800 |
| PRO | 5,000/min | 500,000 | 3,000 | 3,000 |
When a per-minute rate limit is exceeded, the API returns a 429 Too Many Requests response with standard X-RateLimit-* headers indicating when the limit window will reset.
When a monthly limit (calls, links, or QR codes) is exceeded, the API also returns a 429 response but includes a resetDate field. Monthly quotas reset on the first day of the next UTC month at 00:00:00 UTC.
Rate Limit Error Response
json
{
"statusCode": 429,
"message": "Rate limit exceeded. Try again in the next minute."
}