Rate Limiting

The Renta REST API enforces rate limits to ensure fair usage and system stability.
Limits are applied per user across all API resources.

Limit type	Title
Per Minute	120 requests per minute
Per Hour	2000 requests per hour

Rate Limit headers

Every API response includes headers that let you track your current quota usage:

Header	Description
X-RateLimit-Limit-Minute	Maximum number of requests allowed per minute.
X-RateLimit-Remaining-Minute	Number of requests remaining in the current minute window.
X-RateLimit-Reset-Minute	UNIX timestamp when the current minute window resets.
X-RateLimit-Limit-Hour	Maximum number of requests allowed per hour.
X-RateLimit-Remaining-Hour	Number of requests remaining in the current hour window.
X-RateLimit-Reset-Hour	UNIX timestamp when the current hour window resets.

If you exceed your quota, the API responds with an HTTP 429 Too Many Requests error.
The response body provides details about the exceeded limit:

{
  "is_success": false,
  "data": {
    "error_code": 429,
    "message": "Rate limit exceeded: 120 requests per minute",
    "limit_type": "minute",
    "limit": 120,
    "remaining": 0,
    "reset_time": 1758459864
  }
}

Rate Limit response parameters explanation

Parameter	Type	Description
error_code	integer	HTTP status code indicating the type of error. 429 specifically means "Too Many Requests"
message	string	Human-readable error message describing what happened and the current rate limit
limit_type	string	Time window for the rate limit. Indicates whether the limit is per minute or per hour.
limit	integer	Maximum number of requests allowed within the specified time window
remaining	integer	Number of requests remaining before the limit is reached. 0 means limit is exceeded
reset_time	integer	Unix timestamp (seconds since epoch) when the rate limit window resets and requests are allowed again

Ready to get started?

Build your data pipeline today or get a personalized demo. Start free!

Need help?

Get expert support to ensure your project succeeds. We're here to help!

Feature requests?

Help shape our product! Share your ideas for new features and integrations.