> ## Documentation Index
> Fetch the complete documentation index at: https://docs.braintest.ir/llms.txt
> Use this file to discover all available pages before exploring further.

# Braintest API Rate Limits

> Braintest API enforces per-minute and per-hour rate limits on every API key. Learn the limits, the 429 response, and how to handle throttling.

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:

| Window     | Maximum requests |
| ---------- | ---------------- |
| Per minute | 100              |
| Per hour   | 3,000            |

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:

```json theme={"dark"}
{
  "data": null,
  "successful": false,
  "messages": [
    "Rate limit exceeded. Please try again later."
  ]
}
```

## 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.

## Related pages

* [Errors](/reference/errors): full list of HTTP status codes and error envelope format.
* [Status Codes](/reference/status-codes): record and roadmap lifecycle status reference.