Skip to main content
The Volubile API implements rate limiting to prevent abuse and ensure fair usage across all clients.

Limits

  • Per customer account: 100 requests per 15 seconds across all endpoints. You can send up to 100 requests at once, and the quota refills continuously at that rate. Requests made with an API key and with the Bearer tokens it issued share this quota.
  • Token issuance: POST /v1/auth/token is also limited to 10 tokens per minute per API key. Reuse a Bearer token until it expires instead of requesting a new one for each call.

Rate Limit Response

The following headers are included with every API response:
  • X-RateLimit-Limit: Indicates the maximum number of requests a client can make within the rate limit window.
  • X-RateLimit-Remaining: Shows the number of requests remaining before the limit is reached.
On POST /v1/auth/token, these headers describe the token issuance limit. If a client exceeds a rate limit, the API will respond with a 429 Too Many Requests status code. In this case, the Retry-After header is included, indicating the number of seconds the client should wait before making another request to avoid being rate-limited.