Skip to main content

​
Rate Limit Exceeded

Rate Limit Exceeded

​
type
string
https://docs.username.dev/errors/rate-limit-exceeded
​
status
integer
429
​
When it occurs
You’re exceeding the rate limit of 5 requests per second per API key. Making requests faster than this limit will trigger this error.
​
How to fix
  1. Implement exponential backoff retry logic - The response includes a retryAfter field (in seconds) indicating when to retry
  2. Implement request queuing - Queue requests and process them at a rate that doesn’t exceed 5 RPS
  3. For high-volume use cases - Contact us for enterprise rate limit options
{
  "type": "https://docs.username.dev/errors/rate-limit-exceeded",
  "title": "Rate Limit Exceeded",
  "status": 429,
  "detail": "Rate limit exceeded. Please retry after 1 second.",
  "instance": "/check?input=test",
  "retryAfter": 1
}
Don’t ignore the retryAfter field. Retrying immediately will likely result in another 429 error. Always wait for the specified duration before retrying.
Example scenario: Making rapid-fire requests in a loop without rate limiting, or batching too many requests simultaneously.