Endpoints

The HTTP endpoints for our API.

Ratelimits

Standard bots have a maximum of 5 requests per second, however verified bots have a maximum of 15 requests per second. Abusing our API may result in consequences such as permanently blocking your access to using our API.

Authorisation

All endpoints require authorisation as of API v1 Revised.

Exemptions

We may decide to make exemptions allowing certain services to access our API endpoints without authorisation required and/or disabling ratelimits.

get
All Endpoints (*)

https://api.discordextremelist.xyz/v1/*
Shows responses you may receive from all endpoints on /v1/* (Excluding Widgets).
Request
Response
Request
‚Äč
Response
401: Unauthorized
This will be returned if you do not provide a token.
{
"error": true,
"status": 401,
"message": "Unauthorized"
}
403: Forbidden
This will be returned if your token is invalid.
{
"error": true,
"status": 403,
"message": "Invalid Authorization"
}
404: Not Found
When you attempt to GET/POST to an endpoint that doesn't exist.
{
"error": true,
"status": 404,
"message": "Unknown Endpoint"
}
429: Too Many Requests
Returned when you hit the ratelimit.
{
"error": true,
"status": 429,
"message": "Too Many Requests",
"expiry": 10 // Integer - in Seconds
}

get
Website Stats

https://api.discordextremelist.xyz/v1/stats
Get JSON encoded information about the website.
Request
Response
Request
Headers
authorization
required
string
Your bot's api token.
Response
200: OK
You will be returned JSON encoded statistics of the website server, bots and user counts.
{
"error": false,
"status": 200,
"stats": {
"servers": {
"total": 0
},
"bots": {
"total": 0,
"approved": 0,
"verified": 0
},
"users": {
"total": 0,
"verified": 0,
"staff": {
"total": 0,
"mods": 0,
"admins": 0
}
}
}
}

get
Bot Information

https://api.discordextremelist.xyz/v1/bot/:id
Get JSON encoded information about a bot.
Request
Response
Request
Path Parameters
id
required
string
The bot's Discord ID.
Headers
authorization
required
string
Your bot's api token.
Response
200: OK
You will be returned JSON encoded information about a bot.
{
"error": false,
"status": 200,
"bot": {
"avatar": {
"hash": "514ace79af511823e12f75f8b8a4c939",
"url": "https://cdn.discordapp.com/avatars/568254611354419211/514ace79af511823e12f75f8b8a4c939"
},
"id": "568254611354419211",
"inviteCount": 0,
"library": "discord.js",
"links": {
"donation": "https://example.com/givememoney",
"invite": "https://example.com/discordinvite?ref=interestingtrackerthingieidk", // Is blank if permissionless
"repo": "https://github.com/suchuser/suchrepo",
"support": "https://discord.gg/suchsupportlovely",
"website": "https://example.com"
},
"longDesc": "amazing",
"name": "Discord Extreme List",
"owner": {
"id": "208105877838888960"
},
"prefix": "$",
"serverCount": 0,
"shortDesc": "such a good bot",
"status": {
"approved": false,
"pendingVerification": false,
"verified": false
}
}
}
404: Not Found
The bot ID you inputted was not found in DEL's database. (The bot isn't listed on DEL).
{
"error": true,
"status": 404,
"message": 'Unknown Bot'
}

get
User Information

https://api.discordextremelist.xyz/v1/user/:id
Get JSON encoded information about a user.
Request
Response
Request
Path Parameters
id
required
string
The user's Discord ID.
Headers
authorization
required
string
Your bot's api token.
Response
200: OK
You will be returned JSON encoded information about a user.
{
"error": false,
"status": 200,
"user": {
"avatar": {
"hash": "7231f68b03693fd0554b4c984e2c02c3",
"url": "https://cdn.discordapp.com/avatars/208105877838888960/7231f68b03693fd0554b4c984e2c02c3"
},
"discrim": "0001",
"fullUsername": "Cairo#0001",
"game": {
"snakes": {
"maxScore": 0
}
},
"id": "208105877838888960",
"name": "Cairo",
"profile": {
"bio": "",
"css": "",
"links": {
"github": "Username",
"gitlab": "Username",
"instagram": "Username",
"snapchat": "Username",
"twitter": "@Username",
"website": "https://example.com"
}
},
"rank": {
"admin": false,
"mod": false,
"verified": false
}
}
}
404: Not Found
The user ID you inputted was not found on DEL's database. (The user hasn't logged on to DEL before).
{
"error": true,
"status": 404,
"message": 'Unknown User'
}

get
Bot Widget

https://api.discordextremelist.xyz/v1/bot/:id/widget
Get a bot widget in the PNG or SVG format - Defaults to PNG.
Request
Response
Request
Path Parameters
id
required
string
The bot's Discord ID.
Query Parameters
type
optional
string
Append ?type=svg to the url for an svg version of the bot widget, widget defaults to png.
Response
200: OK
You will receive your bot's widget in the PNG format or SVG format if you modified the type.
// PNG or SVG Image Returned
404: Not Found
The bot ID you inputted was not found in DEL's database. (The bot isn't listed on DEL).
{
"error": true,
"status": 404,
"message": 'Unknown Bot'
}

post
Bot Guild Count

https://api.discordextremelist.xyz/v1/bot/:id
Update your bot's guild count (to show how many servers your bot is in on it's profile). NOTICE: Inputting false numbers is against DEL's Guidelines and will result in termination of your bot's listing and termination of access of most of the features on DEL.
Request
Response
Request
Path Parameters
id
required
string
The ID of the bot that you are updating the guild count of.
Headers
authorization
required
string
Your bot's api token.
Body Parameters
guildCount
required
number
Your bot's server/guild count goes here.
Response
200: OK
The server count was successfully updated with the number you supplied.
{
"error": false,
"status": 200,
"message": 'Successfully Updated'
}
400: Bad Request
A new value for the servers (that is meant to be included in the body of the request) was not included or an invalid number was inputted (Example: characters instead of numerals: one two three, 123).
{
"error": true,
"status": 400,
"message": 'guildCount is Required and Must be a Valid Integer'
}
404: Not Found
The bot ID you inputted was not found in DEL's database. (The bot isn't listed on DEL).
{
"error": true,
"status": 404,
"message": 'Unknown Bot'
}