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

# Rate Limits

> API rate limits and usage quotas

## Overview

To ensure fair usage and service quality, the API implements rate limits based on your API key.

<Info>
  **Current Limit:** 20 POST requests per minute per API key
</Info>

***

## Rate Limit Rules

| Rule            | Value                       |
| --------------- | --------------------------- |
| **Limit**       | 20 POST requests per minute |
| **Time Window** | 60 seconds (1 minute)       |

***

## Error Response

When you exceed 20 POST requests per minute:

```json theme={null}
{
  "code": 429,
  "msg": "Rate limit exceeded. Please try again later.",
  "data": null
}
```

**What to do:**

* Wait for the time specified in `retryAfter` (seconds)
* Reduce POST request frequency

***

## Best Practices

<CardGroup cols={2}>
  <Card title="Use Webhooks" icon="webhook">
    Use webhooks instead of polling for status updates
  </Card>

  <Card title="Monitor Headers" icon="chart-line">
    Check X-RateLimit-Remaining to avoid hitting limits
  </Card>

  <Card title="Queue Requests" icon="list">
    Spread POST requests over time
  </Card>

  <Card title="Use GET for Status" icon="eye">
    GET requests are not limited - use them for checking status
  </Card>
</CardGroup>

***

## Need Help?

If you're experiencing rate limit issues, contact [support@jogg.ai](mailto:support@jogg.ai).
