Rate Limiting

To ensure fair usage and system stability, SnapValid API requests are rate limited.

Limit

Limit TypeValue
Requests per minute60 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