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
Request
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.
Response
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
Request
Path Parameters
id
required
string
The ID of the server you want to retrieve.
Response
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
Request
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.
Response
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
}
​
serverlist.space - Previous
General
Next - serverlist.space
Users
Last updated 2 years ago
Servers

getServers

getServer by ID

getServer Upvotes

get
Servers

get
Server by ID

get
Server Upvotes
