Skip to main content
The Braintest API enforces request rate limits on every API key. This page explains the limits, the response you receive when you exceed them, and how to handle throttling in your integration.

​
Limits

Each API key is subject to two concurrent limits: Both limits apply at the same time. Whichever threshold you reach first triggers the rate limit response.

​
429 response

When either limit is exceeded, the API returns HTTP 429 Too Many Requests with the standard envelope:

​
Handling rate limits

  • Retry the request after waiting for the current window to reset.
  • Batch or space out requests when running bulk operations.
  • Cache responses on your side where possible to avoid redundant calls.
  • If you consistently hit these limits, contact support to discuss a quota adjustment for your account.
  • Errors: full list of HTTP status codes and error envelope format.
  • Status Codes: record and roadmap lifecycle status reference.