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

# Rate Limits

> API rate limits and quotas

# Rate Limits

API requests are subject to rate limits to ensure fair usage and system stability.

## Rate Limit Headers

Rate limit information is included in response headers:

```
X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 999
X-RateLimit-Reset: 1640995200
```

## Rate Limit Tiers

| Tier       | Requests/Hour | Burst  |
| ---------- | ------------- | ------ |
| Standard   | 1,000         | 100    |
| Premium    | 10,000        | 1,000  |
| Enterprise | Custom        | Custom |

## Handling Rate Limits

When rate limit is exceeded:

1. **Status Code**: `429 Too Many Requests`
2. **Retry-After**: Header indicates when to retry
3. **Backoff**: Implement exponential backoff

<Note>
  **Scope**: Tenant-scoped; requires authenticated org context\
  **Availability**: Not available in SuperAdmin
</Note>

***

## Related Pages

* [API Introduction](/api-reference/introduction)
* [Authentication](/api-reference/authentication)
* [Errors](/api-reference/errors)

***

## Permissions & Roles

<Tip>
  Rate limits are per organization. Contact your organization administrator to upgrade your rate limit tier.
</Tip>