Users

get
Get User

https://api.discordlist.space/v2/users/:id
Retrieves a specific user by ID.
Request
Response
Request
Path Parameters
id
required
string
The ID of the user
Response
200: OK
{
"id": "507329700402561045",
"username": "PassTheMayo",
"discriminator": "8620",
"avatar": "8d7b060b71b4a904a965ef89c9a9bff7",
"shortDescription": "",
"banned": false,
"admin": true,
"donator": true,
"createdAt": 1621740577129,
"updatedAt": 1621796515571
}

get
Get User Bots

https://api.discordlist.space/v2/users/:id/bots
Gets a user's bots that are listed.
Request
Response
Request
Path Parameters
id
required
string
The ID of the user
Headers
Authorization
optional
string
A user token (inactive bots are shown if provided)
Response
200: OK
{
"page": 1,
"count": 1,
"countPerPage": 16,
"pageCount": 1,
"sortBy": "username",
"sortDirection": "ascending",
"data": [
{
"username": "serverlist.space",
"discriminator": "9751",
"avatar": "855fe58c1a4d9a82f3f05dc4d76a2107",
"active": true,
"shortDescription": "The official manager bot for serverlist.space.",
"fullDescription": "# serverlist.space\r\nThe official bot for [serverlist.space](https://serverlist.space) that will manage your server listing.\r\n\r\n## Commands\r\n![https://i.postimg.cc/LsNRFW30/commands.png](https://i.postimg.cc/LsNRFW30/commands.png \"Command List\")\r\n\r\n### Servers\r\nCommand | Description\r\n--------------- | -----------\r\n`^^add-server` | Run through the setup to get your server listed on serverlist.space.\r\n`^^server-info` | Retrieve basic information on any server listed.\r\n\r\n### Information\r\nCommand | Description\r\n---------- | -----------\r\n`^^donate` | Gets you the link to the official botlist.space and serverlist.space Patreon page.\r\n`^^help` | Lists all available commands.\r\n`^^invite` | Gets the invite link to invite the bot to your own server.\r\n`^^ping` | Pong.\r\n`^^since` | Tells you how long you have been in this server for.\r\n\r\n## Support\r\nIf you need any additional support with this bot, you can join our server by clicking `Support Server` at the top of this listing page.\r\n\r\n## Feature Requests/Bug Reports\r\nRefer to the `Support` section above.",
"inviteURL": "https://discordapp.com/oauth2/authorize?client_id=527964667721678897&scope=bot&permissions=19457",
"supportServer": "GjEWBQE",
"safeAvatar": true,
"owner": {
"username": "PassTheMayo",
"discriminator": "8620",
"avatar": "8d7b060b71b4a904a965ef89c9a9bff7",
"shortDescription": "",
"banned": false,
"admin": true,
"donator": true,
"createdAt": 1621740577129,
"updatedAt": 1621796515571,
"id": "507329700402561045"
},
"secondaryOwners": [],
"serverCount": 17899,
"vanity": "serverlist",
"websiteURL": "https://serverlist.space",
"tags": [
{
"type": "bot",
"name": "Utility",
"bots": 646,
"servers": 0,
"id": "utility"
},
{
"type": "bot",
"name": "Web Dashboard",
"bots": 98,
"servers": 0,
"id": "web-dashboard"
}
],
"languages": [
{
"name": "Unknown/Other",
"bots": 1868,
"servers": 0,
"id": "other"
}
],
"prefix": "^^",
"createdAt": 1546568784832,
"updatedAt": 1621796515633,
"upvoteCount": 0,
"id": "527964667721678897"
}
]
}

get
Get User Servers

https://api.discordlist.space/v2/users/:id/servers
Gets a user's servers that are listed.
Request
Response
Request
Path Parameters
id
required
string
The ID of the user
Headers
Authorization
optional
string
A user token (inactive servers are shown if provided)
Response
200: OK
{
"page": 1,
"count": 2,
"countPerPage": 16,
"pageCount": 1,
"sortBy": "name",
"sortDirection": "ascending",
"data": [
{
"name": "discordlist.space",
"shortDescription": "The official support server for botlist.space and serverlist.space.",
"fullDescription": "",
"icon": "70ec291cf1dcaa33f8c50d5b3333a521",
"active": true,
"memberCount": 2591,
"inviteCode": "GjEWBQE",
"owner": {
"username": "PassTheMayo",
"discriminator": "8620",
"avatar": "8d7b060b71b4a904a965ef89c9a9bff7",
"shortDescription": "",
"banned": false,
"admin": true,
"donator": true,
"createdAt": 1621740577129,
"updatedAt": 1621796515571,
"id": "507329700402561045"
},
"secondaryOwners": [],
"tags": [
{
"type": "server",
"name": "Community",
"bots": 0,
"servers": 63,
"id": "community"
}
],
"safeAvatar": true,
"vanity": null,
"showEmojis": true,
"websiteURL": null,
"createdAt": 1561956455291,
"updatedAt": 1621879171508,
"upvoteCount": 0,
"emojis": [
{
"name": "nope",
"animated": false,
"createdAt": null,
"id": "509251483154513921"
},
{
"name": "botAdded",
"animated": false,
"createdAt": null,
"id": "484479891832569868"
},
{
"name": "christianserver",
"animated": false,
"createdAt": null,
"id": "509251858141806610"
},
...
],
"id": "387812458661937152"
}
]
}

get
Get User Reviews

https://api.discordlist.space/v2/users/:id/reviews
Get reviews that a user has posted.
Request
Response
Request
Path Parameters
id
required
string
The ID of the user
Query Parameters
page
optional
number
The page number (min: 1, default: 1)
count
optional
number
The amount of reviews to retrieve per page (min: 1, max: 50, default: 16)
sortBy
optional
string
The property to sort by (default: title)
sortDirection
optional
string
The sort direction (allowed values: ascending, descending, default: ascending)
Response
200: OK
{
"page": 1,
"count": 1,
"countPerPage": 16,
"pageCount": 1,
"sortBy": "title",
"sortDirection": "ascending",
"data": [
{
"user": {
"username": "PassTheMayo",
"discriminator": "8620",
"avatar": "8d7b060b71b4a904a965ef89c9a9bff7",
"shortDescription": "",
"banned": false,
"admin": true,
"donator": true,
"createdAt": 1623854559629,
"updatedAt": 1624321835818,
"id": "507329700402561045"
},
"title": "Amazing bot!",
"comment": "This is one of the best bots out there!",
"rating": 5,
"createdAt": 1624863341103,
"bot": {
"username": "omarpg",
"discriminator": "7525",
"avatar": "3a3a2947838fc29e2588a078a6575492",
"active": true,
"shortDescription": "Start your journey to collect the most Pokémon badges! RPG your pokemon to become the best trainer!",
"fullDescription": "As a pokemon trainer, you start in the Kanto region, where you can catch pokemon and nurture them to increase their levels. The goal is to get stronger every day, and be able to challenge the best trainers of each region, starting with mighty Brock and his rock-solid defense.\r\n\r\no!setup gets you started.\r\n\r\no!tutorial will show you the basics.\r\n\r\no!spinstop will get you pokeballs. You can spin the stop every 5 minutes.\r\n\r\no!player will show your current status.\r\n\r\no!wildmon will show you the pokemon that have spawned in the wild for your current region. Spawns will change every 40-60 minutes.\r\n\r\no!catch is what you need to get the pokemons!\r\n\r\no!mons will show you your current monster inventory. You can hold 10 at the beginning, but getting badges will also reward you with more inventory space.\r\n\r\nFor the complete list of commands go to [www.omarpg.com](https://www.omarpg.com/#/rpg)\r\n",
"inviteURL": "https://discordapp.com/oauth2/authorize?client_id=555170415773745172&scope=bot&permissions=0",
"supportServer": "4SDW8K2",
"safeAvatar": true,
"owner": {
"username": "readonlychild",
"discriminator": "2464",
"avatar": "f4f15601f85ce0441df7ecdadb976d37",
"shortDescription": "",
"banned": null,
"admin": false,
"donator": false,
"createdAt": 1623854560073,
"updatedAt": 1624321835990,
"id": "208659391417679872"
},
"secondaryOwners": [],
"serverCount": 1744,
"vanity": null,
"websiteURL": "https://www.omarpg.com/#/rpg",
"tags": [
{
"type": "bot",
"name": "Utility",
"bots": 679,
"servers": 0,
"id": "utility"
},
{
"type": "bot",
"name": "Leveling",
"bots": 122,
"servers": 14,
"id": "leveling"
},
{
"type": "bot",
"name": "Fun",
"bots": 844,
"servers": 41,
"id": "fun"
}
],
"languages": [
{
"name": "Unknown/Other",
"bots": 1966,
"servers": 0,
"id": "other"
}
],
"prefix": "o!",
"createdAt": 1587328048922,
"updatedAt": 1624321836111,
"upvoteCount": 243,
"reviews": {
"count": 1,
"averageRating": 5
},
"id": "555170415773745172"
},
"upvoted": false,
"upvoteCount": 0,
"id": "288be4bdb10ac11e755dfd0b5a0a5aaadcd090a86bd350a5"
}
]
}

get
Get User Lists

https://api.discordlist.space/v2/users/:id/lists
Get all the lists that a user owns
Request
Response
Request
Path Parameters
id
required
string
The ID of the user
Query Parameters
page
optional
number
The page number (min: 1, default: 1)
count
optional
number
The amount of lists per page (min: 1, max: 50, default: 16)
sortBy
optional
string
The property to sort by (default: name)
sortDirection
optional
string
The sort direction (allowed values: ascending, descending, default: ascending)
Response
200: OK