Skip to main content
GET
/
servers
/
{serverId}
Get Server Details
curl --request GET \
  --url https://api.mcmp.app/v1/servers/{serverId} \
  --header 'Authorization: Bearer <token>'
{
  "id": "<string>",
  "name": "<string>",
  "status": "running",
  "players": 123,
  "maxPlayers": 123,
  "version": "<string>",
  "createdAt": "2023-11-07T05:31:56Z",
  "playerList": [
    {
      "uuid": "<string>",
      "name": "<string>",
      "online": true,
      "lastSeen": "2023-11-07T05:31:56Z"
    }
  ],
  "configuration": {
    "server": {
      "name": "<string>",
      "maxPlayers": 123,
      "version": "<string>",
      "motd": "<string>",
      "difficulty": "peaceful"
    },
    "world": {
      "name": "<string>",
      "seed": "<string>",
      "generator": "<string>"
    }
  }
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

serverId
string
required

The unique identifier of the server

Response

Successful response

id
string
required

Unique server identifier

name
string
required

Server name

status
enum<string>
required

Current server status

Available options:
running,
stopped,
starting,
stopping
players
integer

Number of online players

maxPlayers
integer

Maximum number of players

version
string

Minecraft server version

createdAt
string<date-time>

Server creation timestamp

playerList
object[]

Detailed list of all players (online and offline)

configuration
object