API Documentation

Base URL: https://ping.minecraft-vote.com

GET /3/{address}

Get full status for a Java Edition server

Parameters

address Server hostname or IP. Port optional (default: 25565)

Response

{
  "online": true,
  "host": "mc.hypixel.net",
  "port": 25565,
  "version": "Requires MC 1.8 / 1.21",
  "protocol": 47,
  "players": {
    "online": 45000,
    "max": 200000,
    "list": null
  },
  "motd": {
    "raw": ["...with color codes..."],
    "clean": ["...plain text..."],
    "html": ["...html formatted..."]
  },
  "icon": "data:image/png;base64,...",
  "software": "Paper",
  "debug": { ... }
}
GET /bedrock/3/{address}

Get full status for a Bedrock Edition server

Parameters

address Server hostname or IP. Port optional (default: 19132)

Response

{
  "online": true,
  "host": "play.example.com",
  "port": 19132,
  "version": "1.20.0",
  "protocol": 589,
  "players": { "online": 100, "max": 500 },
  "motd": { ... },
  "gamemode": "Survival",
  "serverid": "..."
}
GET /simple/{address}

Simple online/offline check

Response Codes

200 Server is online
404 Server is offline or unreachable
GET /icon/{address}

Get server icon as PNG

Returns a 64x64 PNG image. Falls back to a default icon if the server has none.

Usage

<img src="https://ping.minecraft-vote.com/icon/mc.hypixel.net">

Debug Endpoints

GET /debug/ping/{address} Raw TCP ping
GET /debug/query/{address} Raw UDP query
GET /debug/bedrock/{address} Raw Bedrock ping

Response Fields

Field Type Description
online boolean Server reachability
players.online integer Current player count
players.max integer Maximum player slots
motd.raw array MOTD with color codes
motd.clean array MOTD plain text
motd.html array MOTD as HTML
icon string Base64 PNG data URI
debug.cachehit boolean Response from cache