API

Public API

All endpoints work without authentication and return JSON (except player heads). Please cache responses and do not poll more than once per minute.

Server status

GEThttps://mc-serverlist.net/api/v1/servers/<slug>

Status, player counts, version, MOTD and votes of the current month.

Check a vote

GEThttps://mc-serverlist.net/api/v1/votes/check?server=<slug>&username=<name>

Returns { "voted": true, "votedAt": "…" } if the player voted in the last 24 hours. Handy for plugins without Votifier.

Player head

GEThttps://mc-serverlist.net/api/skins/<name>?size=64

Head of the Minecraft skin as PNG (including the hat layer), size between 8 and 256 pixels. Unknown names get a placeholder head instead of an error.