To ensure fair usage and system stability, SnapValid API requests are rate limited.
Limit
| Limit Type | Value |
|---|---|
| Requests per minute | 60 per API key |
Each API key can make up to 60 requests per minute.
Rate Limit Exceeded
If you exceed the rate limit, the API returns:
- HTTP Status Code: 429
- JSON error response
Example:
{
"success": false,
"result": "Too Many Requests"
}
Recommended Handling
- When receiving a 429 response:
- Stop sending additional requests
- Wait before retrying (recommended: 60 seconds)
- Implement exponential backoff in production systems
Example retry logic strategy:
- 1st retry: wait 5 seconds
- 2nd retry: wait 15 seconds
- 3rd retry: wait 30 seconds
Best Practices
- Avoid sending bursts of requests
- Implement client-side throttling
- Cache validation results where possible
- Monitor API usage in your dashboard
