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

# Rate Limits

> Understand CoreTone API rate limits by plan tier.

# Rate Limits

CoreTone enforces rate limits to ensure fair usage and platform stability. Limits vary by subscription tier.

## Limits by Plan

| Plan         | Per Minute | Per Day |
| ------------ | ---------- | ------- |
| Starter      | 60         | 1,000   |
| Growth       | 300        | 10,000  |
| Professional | 600        | 50,000  |
| Business     | 1,200      | 100,000 |
| Enterprise   | Custom     | Custom  |

## Rate Limit Headers

Every API response includes rate limit information in the headers:

```
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 58
X-RateLimit-Reset: 1712073600
```

## Handling Rate Limits

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

```json theme={null}
{
  "error": "Rate limit exceeded",
  "retry_after": 45
}
```

**Best practices:**

* Implement exponential backoff on 429 responses
* Cache profile lookup results to reduce redundant calls
* Use the `retry_after` value to determine when to retry
* Monitor your usage in the Developer Portal