Rate Limits
In this guide you can learn more about rate limits and how it impacts you.
Limits
We impose different rate limits depending on the plan you purchased.
| Plan | Validation limits |
|---|---|
| Starter | 50 validations per hour |
| Growth | 1,000 validations per hour |
| Professional | Unlimited |
| Enterprise | Unlimited |
Headers
The API implements the latest IETF rate limiting standard.
You'll receive a 429 Too Many Requests error if you reach this limit.
Both successful and non-successful API responses will include the following headers:
| Header name | Header value |
|---|---|
| RateLimit-Policy | "validations";q=50;w=3600 |
| RateLimit | "validations";r=49;t=3599 |
You can check how many requests you have left using the RateLimit response header's r value. When r becomes 0, you have to wait t seconds to prevent throttling.
Recommendations
Respect rate limit policy
We recommend respecting the rate limit policy sent by the API so you can avoid being throttled.
Allow sign ups when API fails
When integrating Valid Identities in the user's critical path (e.g. in the sign up flow), make sure that you have enough quota left or let the user slip through whenever our API call fails due to exceeded quota.