Servers

get
Servers

https://api.serverlist.space/v1/servers
Retrieves all the servers listed on the site, paginated using query parameters. 16 servers are returned per page.
Request
Response
Query Parameters
reverseSort
optional
boolean
Reverses the sorting order.
sortBy
optional
string
The property of the servers to sort the data by. Defaults to the server ID. Sorts descending first by default unless specified otherwise.
page
optional
number
Selects with page of servers to return. Selects the first page if not provided.
200: OK
{
"success": true, // Boolean
"page": 1, // Number
"page_count": 20, // Number
"servers": [ // Array<Object>
{ ... },
{ ... },
{ ... }
]
}
400: Bad Request
{
"success": false, // Boolean
"code": 400, // Number
"message": "That page does not exist" // String
}
401: Unauthorized
{
"success": false, // Boolean
"code": 401, // Number
"message": "Missing Authorization header" // String
}
403: Forbidden
{
"success": false, // Boolean
"code": 403, // Number
"message": "No user exists with that token" // String
}

get
Server by ID

https://api.serverlist.space/v1/servers/:id
Gets a specific server by an ID.
Request
Response
Path Parameters
id
required
string
The ID of the server you want to retrieve.
200: OK
{
"success": true, // Boolean
"id": "387812458661937152", // String
"name": "botlist.space", // String
"icon": "https://cdn.discordapp.com/icons/387812458661937152/e56ff74366e752e7817349235057504f.jpg?size=256", // String
"short_description": "The official support server for botlist.space.", // String
"full_description": "...", // ?String
"icon_child_friendly": true, // Boolean
"public": true, // Boolean
"compliance": true, // Boolean
"owners": [ // Array<Object>
{
"avatar": "https://cdn.discordapp.com/avatars/149505704569339904/d7083005cb77b45b55d82a4e1fbe104c.png?size=256", // String
"discriminator": "0123", // String
"id": "149505704569339904", // String
"short_description": null, // ?String
"username": "luke" // String
}
],
"tags": [ // ??Array<String>
"Utility"
],
"member_count": 2500, // Number
"vanity": "botlist" // ?String
"created_at": 1509302556022, // Number
"updated_at": 1546153941801, // Number
}
401: Unauthorized
{
"success": false, // Boolean
"code": 401, // Number
"message": "Missing Authorization header" // String
}
403: Forbidden
{
"success": false, // Boolean
"code": 403, // Number
"message": "Invalid Authorization header" // String
}
404: Not Found
{
"success": false, // Boolean
"code": 404, // Number
"message": "Server not found" // String
}

get
Server Upvotes

https://api.serverlist.space/v1/servers/:id/upvotes
Request
Response
Path Parameters
id
required
string
The ID of the server you want to retrieve upvotes from.
Headers
Authorization
required
string
API server token
Query Parameters
page
optional
number
Selects which page of upvotes to return. Selects the first page if not provided.
200: OK
{
"success": true, // Boolean
"page": 2, // Number
"page_count": 6, // Number
"upvotes": [ // ??Array<Object>
{
"user": {
"id": "507329700402561045", // String
"username": "PassTheMayo", // String
"discriminator": "1281", // String
"avatar": "...", // String
"short_description": "..." // ?String
},
"timestamp": 1546208945017 // Number
},
...
]
}
401: Unauthorized
{
"success": false, // Boolean
"code": 401, // Number
"message": "Missing Authorization header" // String
}
403: Forbidden
{
"success": false, // Boolean
"code": 403, // Number
"message": "Invalid Authorization header" // String
}
404: Not Found
{
"success": false, // Boolean
"code": 404, // Number
"message": "Server not found" // String
}

‚Äč