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

# Rate Limits

> Understanding CubeStack API rate limits.

# Rate Limits

CubeStack applies rate limits to ensure fair usage and platform stability.

## Default Limits

| Plan       | Requests per Minute |
| ---------- | ------------------- |
| Free       | 60                  |
| Pro        | 300                 |
| Enterprise | Custom              |

## Rate Limit Headers

Every API response includes rate limit information:

| Header                  | Description                           |
| ----------------------- | ------------------------------------- |
| `X-RateLimit-Limit`     | Maximum requests per window           |
| `X-RateLimit-Remaining` | Remaining requests in current window  |
| `X-RateLimit-Reset`     | Unix timestamp when the window resets |

## Exceeding the Limit

When you exceed the rate limit, the API returns a `429 Too Many Requests` response:

```json theme={null}
{
  "error": "Rate limit exceeded. Try again later."
}
```

## Best Practices

* Cache responses when possible
* Use pagination to reduce the number of requests
* Implement exponential backoff on `429` responses
* Contact support if you need higher limits