API Documentation

Java Server Status

Endpoint: /api/status/:serverAddress

Method: GET

Response (Online):

{
  "version": {
    "name": "1.16.5",
    "protocol": 754
  },
  "players": {
    "max": 20,
    "online": 5,
    "list": [
      {
        "name": "EducatedSuddenBucket",
        "id": "uuid1"
      },
      {
        "name": "SomeoneElseInTheServer",
        "id": "uuid2"
      }
    ]
  },
  "description": "A Minecraft Server",
  "latency": 123,
  "favicon": "data:image/png;base64,..."
}

Response (Offline):

{
  "error": "Server offline"
}

Server Icon (Java Only)

Endpoint: /api/png/:serverip

Method: GET

Response: Image (PNG)

Response (Error):

{
  "error": "Server offline or no favicon"
}

Bedrock Server Status

Endpoint: /api/status/bedrock/:serverAddress

Method: GET

Response (Online):

{
  "motd": "Dedicated Server",
  "levelName": "Bedrock level",
  "playersOnline": 0,
  "playersMax": 10,
  "gamemode": "Survival",
  "serverId": "13460148391903423507",
  "protocol": "686",
  "version": "1.21.3",
  "latency": 50
}

Response (Offline):

{
  "error": "Server offline"
}