> For the complete documentation index, see [llms.txt](https://docs.roleplaybot.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roleplaybot.xyz/api/errors/rate-limited.md).

# Rate limited

{% hint style="danger" %}
The API has been deprecated and is no longer in use.
{% endhint %}

The rate limit system is implemented to prevent abuse and spam requests reaching our endpoints, For example malicious software can be used to constantly request an endpoint and overload the server, Stopping other from using it. This is the reason why we have introduced a rate limit system, Below you can view the global rate limit and specific endpoints rate limit (Any endpoint not specified follows the global rate limit).

### Headers

| Header Name           | Description                                                  |
| --------------------- | ------------------------------------------------------------ |
| X-RateLimit-Limit     | The amount of requests you can make                          |
| X-RateLimit-Remaining | The amount of remaining requests you can make                |
| X-RateLimit-Reset     | Epoch (Millisecond) timestamp at which the rate limit resets |

### Global Rate Limit

The global rate limit is set at **20 requests per second**, This is reasonable for any minor actions or projects that don't require many requests to be called simultaneously.

### Exact Rate Limit

Exact rate limit affects any direct endpoint route, For example `/civilian` and `/firearm` have routed endpoints making them apart of the exact rate limit. The exact rate limit is currently set to **10 requests per second as** these endpoints complete direct requests to the database.

{% hint style="warning" %}
**If your project is constantly getting rate limited due to the amount of requests then please get in contact with** [**RoleplayBot Support**](https://roleplaybot.xyz/support)**, We may be able to increase your rate limit.**
{% endhint %}