Skip to main content

​
Rate limits

Limits are applied per API key.
API EndpointsLimitDefaultResets
General AvailabilityRequests per minute60Rolling 60-second window
Requests per day10,000Midnight UTC
Research PreviewRequests per second5Rolling window
Exceeding either limit returns 429 Too Many Requests. Use exponential backoff before retrying: 
import time
from revenuebase_sdk import RevenuebaseClient, RateLimitError

client = RevenuebaseClient()

def call_with_backoff(email, max_retries=5):
    for attempt in range(max_retries):
        try:
            return client.email.verify(email=email)
        except RateLimitError:
            wait = 2 ** attempt  # 1s, 2s, 4s, 8s, 16s
            time.sleep(wait)
    raise RuntimeError("Max retries exceeded")

​
Track usage with response headers

Every response includes rate limit headers:
HeaderDescription
X-RateLimit-LimitMax requests allowed in the current window
X-RateLimit-RemainingRequests remaining in the current window
X-RateLimit-ResetUnix timestamp when the window resets
Read X-RateLimit-Reset before retrying to avoid sending requests that will immediately fail.

​
Error codes

StatusCauseFix
400 Bad RequestMalformed request body or missing required parametersCheck required fields and data types
401 UnauthorizedMissing or invalid API keyVerify the x-key header is present and the key is correct
403 ForbiddenKey is valid but not authorized for this endpointCheck your account tier and key permissions
404 Not FoundEndpoint or resource doesn’t existCheck the URL and endpoint version (/v1/ vs /v2/)
422 Validation ErrorRequest parsed correctly but failed field validationFix the fields listed in the detail array (see below)
429 Too Many RequestsRate limit exceededWait for the window to reset; use exponential backoff
500 Server ErrorUnexpected error on our endRetry with backoff; contact support@revenuebase.ai if it persists

​
Parse a 422 Validation Error

Validation errors return a detail array identifying each failing field: 
{
  "detail": [
    {
      "loc": ["body", "email"],
      "msg": "value is not a valid email address",
      "type": "value_error.email"
    }
  ]
}
loc identifies where the problem is (e.g. ["body", "email"]), and msg tells you what’s wrong. Fix each entry in the array and retry.

​
Next steps