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.

PlanValidation limits
Starter50 validations per hour
Growth1,000 validations per hour
ProfessionalUnlimited
EnterpriseUnlimited

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 nameHeader 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.