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

# Rate limits

> Default request and concurrency limits, and the headers that report them.

Limits are per account and shared across all your API keys.

| What | Default |
| - | - |
| Starting a run (`POST .../run`) | 60 per minute |
| Everything else (status, results, catalog, balance) | 1,200 per minute |
| Runs in progress at once | 500 |

Checking on runs never uses up your allowance for starting them.

## Headers

Responses to keyed requests carry `RateLimit-Limit`, `RateLimit-Remaining` and `RateLimit-Reset` (seconds until a slot frees), also sent as `X-RateLimit-*`, plus `RateLimit-Policy`.

## When you hit a limit

You get HTTP `429` with `error.code` set to `rate_limited` or `too_many_concurrent_runs`. Wait for the `Retry-After` header and try again. If it's absent, back off from 0.5 seconds, doubling each time, with some random jitter.

Separately, a run can fail with `internal_error` when our own capacity is busy. That run is `retryable`, with `retry_after_seconds` set to 60.

> [!NOTE]
>
> Need higher limits for a production workload? [Book a call](https://cal.com/saurabhshubham/30min) and we'll raise them.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.