Bots on Discord Bot API

Getting Started

To use the bot API you first need an API key. To get one go to the API Keys page under your username on the navbar. This key goes in the Authorization header of all API requests.

Bots should send all API requests to with authentication. Ratelimits are used in all routes and appear in response headers.

If a request fails it will have a message field in the response body explaining the problem.

Guild Count

Update a bot's guild count. Trying to update the guild count for a bot that is not approved will return a 404 Not Found error.

Endpoint: POST /bots/:id/guilds
Ratelimit: 1req / 2min / bot

Sample request:

Authorization: b1c678e8b0a346efe45e97c12b28f074
Content-Type: application/json

	"guildCount": 54783

Returns: 204 No Content

Check Review

Check if a user has reviewed a bot. Returns a JSON response with the field exists, indicating if a review exists.

Endpoint: GET /bots/:id/review?owner={user id}
Ratelimit: 20req / 10s / bot

Sample request:

Authorization: b1c678e8b0a346efe45e97c12b28f074


	"exists": true

Tip: Be careful what permissions you give bots. Only give them the permissions they need.