Under constructionThe exact rate limit values are still subject to change. Use the response headers described below to check the current limit for your instance, rather than relying only on the values mentioned on this page.
The Xentral API is rate limited to 100 requests per minute per instance, independent of your Xentral plan.
If you exceed the limit, the API responds with 429 - Too Many Requests.
Checking your current limit
Every API response includes headers with your current rate limit status:
| Header | Description |
|---|---|
X-RateLimit-Limit | The maximum number of requests allowed per minute for your instance. |
X-RateLimit-Remaining | The number of requests remaining in the current window. |
Retry-After | Seconds to wait before retrying. Only on 429. |
X-RateLimit-Reset | Unix timestamp when the current window resets. Only on 429. |
Requesting a higher limit
If your integration needs a higher rate limit than the default, you can request an increase by contacting [email protected]. Let us know whether you need the increase temporarily (e.g. for a one-time data migration) or as part of your permanent setup.
Please noteEvery request is reviewed individually. Whether an increase can be granted, and to what extent, depends on factors such as your subscription plan and instance size — it is not guaranteed.
EnforcementIf you rely on the API for proper functionality now or in the future, make sure you are not exceeding the limits stated on this page or returned in the
X-RateLimit-Limitheader.