Ratelimits

To protect our API against excessive abusive behavior, we have simple rate limits in place.

danger

Your application must obey these rate-limits. Repeated violation of rate-limits will result in a permanent ban of your application.

Rate-limit headers

If the endpoint you're using is rate-limited, each response from that endpoint will contain rate-limit headers. Your application must adapt its behavior to these headers.

important

Although rate-limits per endpoint are relatively constant, they may change at any time without warning. Therefore, it's strictly required that your application reads and respects our headers and does not hardcode any rate-limits.

You'll receive the following headers in responses:

Header	Value Type	Description
Y-RateLimit-Bucket	String	The bucket of the current rate-limit. A rate-limit bucket is usually related to one single endpoint on one single guild - that means that you have to respect one rate-limit per endpoint and guild in general, but multiple endpoints and/or guilds may share a bucket. Therefore, it's required that you respect rate-limits based on buckets rather than endpoints or guilds.
Y-RateLimit-Permits	int	Amount of requests you can perform against endpoints in this bucket in the current period.
Y-RateLimit-ResetIn	int	Time in milliseconds until the bucket gets reset. If Y-RateLimit-Permits is 0, your application must wait at least this amount of milliseconds before sending the next request to an endpoint in the same bucket.