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

# Ratelimits

> To protect our API against abusive behaviour, we have simple ratelimits in place.

<Warning>
  Your application must obey these ratelimits. Repeated violation of ratelimits will result in a permanent API ban for this guild
</Warning>

<Note>
  Ratelimits may change at any time without warning. Therefore it is important that your application reads and respects our headers
</Note>

Rate-limiting errors (`429`) happen when you're sending too many requests to our API.
The following headers are included in each API response to help you track your request usage:

| Header                  | Description                                                                |
| ----------------------- | -------------------------------------------------------------------------- |
| `x-ratelimit-limit`     | Maximum number of requests allowed in the current time window.             |
| `x-ratelimit-remaining` | Number of requests left in the current time window.                        |
| `x-ratelimit-reset`     | How many seconds must pass before the rate limit resets                    |
| `retry-after`           | Time (in seconds) before new requests can be made after reaching the limit |

If the rate limit is exceeded, further requests may be temporarily blocked until the reset time specified in the `x-ratelimit-reset` header.

<Note>
  Rate limits are applied on a **per-guild basis**, so the rate limit for one guild will not affect the limits of your other guilds.
</Note>