API Rate Limits

In order to ensure the stability and reliability of our service, the SaaS Custom Domains API enforces rate limits. Understanding these limits and how they are communicated is crucial for efficient and error-free API usage.

Understanding Rate Limits

The SaaS Custom Domains API allows up to 120 requests per minute. This rate limit is designed to prevent abuse and ensure equitable access to our services for all users. If you require a higher rate limit, reach out to our support team.

Exceeding Rate Limits

If you exceed the rate limit of 120 requests per minute, your additional requests will be rejected, and you will receive a 429: Too Many Requests status code. Along with this, the response body will include the following information:

  "error": "Rate Limit Exceeded",
  "error_code": "rate_limited"

Rate Limit Headers

When your request is rate limited, i.e. when you get the 429: Too Many Requests response, the response will also include additional headers that provide information about your current rate limit status:

  • X-RateLimit-Limit: The maximum number of requests you can make per minute. For our API, this is set to 120.
  • X-RateLimit-Remaining: The number of requests you can still make in the current minute window.
  • X-RateLimit-Reset: The timestamp (in Unix epoch time) when the rate limit will reset.

These headers are instrumental in managing your API usage and ensuring that you stay within the rate limits.