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

# Rate limits

> Understand API rate limiting and how to stay within your quota

API requests are rate-limited to **2,000 requests per 10-minute window** per API credential. List endpoints cost **10 credits** per call; all other endpoints cost **1 credit**.

## Response headers

Rate limit status is returned on every response:

| Header                   | Description                                    |
| ------------------------ | ---------------------------------------------- |
| `X-Rate-Limit-Limit`     | Maximum requests allowed in the current window |
| `X-Rate-Limit-Remaining` | Requests remaining in the current window       |
| `X-Rate-Limit-Reset`     | Seconds until the window resets                |

## Exceeding the limit

When the limit is exceeded, the API returns `429 Too Many Requests`. Wait for the window to reset before retrying — check the `X-Rate-Limit-Reset` header for the number of seconds remaining.

<Tip>Monitor `X-Rate-Limit-Remaining` in your integration to throttle requests before hitting the limit, rather than reacting to `429` errors.</Tip>

## Credit costs

| Endpoint type                                            | Credits per call |
| -------------------------------------------------------- | ---------------- |
| List endpoints (e.g., `GET /events`, `GET /registrants`) | 10               |
| All other endpoints                                      | 1                |
