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

# Rate Limiting

> Understand API rate limits

The GoSentrix API implements rate limiting to ensure fair usage and prevent abuse.

## Rate Limit Headers

Every API response includes rate limit headers:

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

## Default Limits

| Endpoint Type  | Limit              |
| -------------- | ------------------ |
| Public API     | 1000 requests/hour |
| Control Plane  | 500 requests/hour  |
| Authentication | 10 requests/minute |

## Per-Tenant Limits

Rate limits are applied per tenant, ensuring isolation between organizations.

## Rate Limit Exceeded

When rate limited, you'll receive:

<ResponseExample>
  ```json theme={null}
  {
    "error": {
      "code": "rate_limit_exceeded",
      "message": "Too many requests",
      "retry_after": 60
    }
  }
  ```
</ResponseExample>

## Best Practices

* Monitor rate limit headers
* Implement exponential backoff
* Cache responses when possible
* Use webhooks instead of polling
* Contact support for higher limits