API Rate Limits

To maintain optimal performance and ensure fair usage, Verifiet API enforces rate limits on requests. This page outlines the rate limit policies and provides guidance on handling rate limit errors.

Rate Limit Policy

1. Standard Rate Limits

  • Requests per Second: 100 requests
    • Overall, the API supports 100 requests per second.
  • Burst Rate Limits: 1000 requests
    • You can make up to 1000 burst requests.
  • Client Level Limits: Vary based on client credentials
    • Most clients are set to a few hundred requests per day (e.g., integration test = 1440 per day, sandbox = 360 per day, ai prise = 100 per day).

2. Burst Rate Limits

  • Short Bursts: You can make up to 20 requests in a 5-second window without hitting the rate limit.
    • Note: After a burst, reduce the request rate to avoid hitting the standard rate limits.

3. Rate Limits by Endpoint

  • Some endpoints may have different limits:
    • /v1/entities: 30 requests per minute
    • /v1/reports: 15 requests per minute
  • Custom rate limits may be available for high-volume use cases. Contact support for details.

Handling Rate Limit Errors

1. Error Response

  • If you exceed the rate limit, the API will return a 429 Too Many Requests error.
  • Response Message: “Rate limit exceeded. Please wait and try again later.”
  • Retry-After Header: Indicates the number of seconds to wait before making another request.

2. Best Practices to Avoid Rate Limits

  • Implement Exponential Backoff: Retry requests after increasing intervals if you hit a rate limit.
  • Optimize API Calls: Batch requests or minimize calls to stay within limits.
  • Monitor Usage: Track your API usage and adjust your request rate accordingly.

3. Rate Limit Monitoring

  • Headers for Tracking:
    • X-RateLimit-Limit: Maximum number of requests allowed in the current time window.
    • X-RateLimit-Remaining: Number of requests remaining in the current time window.
    • X-RateLimit-Reset: Time when the rate limit will reset (in Unix epoch format).

Custom Rate Limits

  • Enterprise Plans: Custom rate limits are available for enterprise customers. Contact your account manager or support team to discuss your needs.