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

# Rate Limiting

> Understand API rate limits and how to handle them in your application

## Overview

The Cometly API implements rate limiting to ensure fair usage and maintain service quality for all users. Rate limits are applied per Space and are enforced per minute. Each endpoint has specific rate limits documented on its respective page.

## Rate Limit Headers

Every API response includes headers that provide information about your current rate limit status:

| Header                  | Description                                                       |
| ----------------------- | ----------------------------------------------------------------- |
| `X-RateLimit-Limit`     | The maximum number of requests allowed in the current time window |
| `X-RateLimit-Remaining` | The number of requests remaining in the current time window       |
| `Retry-After`           | (Only on 429 responses) Number of seconds to wait before retrying |

## Rate Limit Response

When you exceed a rate limit, the API will return a `429 Too Many Requests` status code.

The response will include a `Retry-After` header indicating how many seconds you should wait before making another request.

## Need Higher Limits?

If your use case requires higher rate limits, please contact our support team at [support@cometly.com](mailto:support@cometly.com) to discuss custom rate limit options for your account.