Rate Limiting

The LeadX API enforces rate limits to ensure fair usage and maintain optimal performance for all end users. Rate limiting restricts the number of requests a client can make within a specific time window. If you exceed the allowed limit, the API will respond with a 429 Too Many Requests error.

How Rate Limiting Works

The standard rate limit is 60 API calls per minute. The API uses the client's IP address to track the number of requests. Once the limit is exceeded, further requests will be temporarily blocked until the time window resets. If you exceed the rate limit, you will receive a response body like this:

{
  "success": false,
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Rate limit exceeded",
    "status": 429,
    "request_id": "3f12b95d-743b-4a97-a306-5f616c9bd0c7",
    "timestamp": "2026-08-20T19:34:56+00:00"
  }
}

The request_id and timestamp values are unique to each response. Check the Retry-After response header to determine how many seconds to wait before retrying.