Ratelimits
To protect our API against abusive behaviour, we have simple ratelimits in place.
Your application must obey these ratelimits. Repeated violation of ratelimits will result in a permanent API ban for this guild
Ratelimits may change at any time without warning. Therefore it is important that your application reads and respects our headers
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.
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.