Developers

Minecraft server status API

Free JSON API to check Minecraft Java and Bedrock server status — MOTD, players, version, protocol, plugins, and favicon. Responses are cached for 60 seconds and include CORS headers for browser clients.

Endpoints

Java

/api/v1/java

Default port 25565. Uses Server List Ping and Query when available.

GET /api/v1/java?host=play.hypixel.net

Bedrock

/api/v1/bedrock

Default port 19132. Uses the Bedrock RakNet unconnected ping.

GET /api/v1/bedrock?host=geo.hivebedrock.network

API index

/api/v1

Lists available endpoints.

GET /api/v1

Query params

  • host — hostname or IP (required). Aliases: address, ip. You can also pass host:port.
  • port — optional override.

Example response (online)

{
  "online": true,
  "ip": "127.0.0.1",
  "port": 25565,
  "hostname": "play.example.net",
  "edition": "java",
  "version": "1.21.1",
  "protocol": { "version": 767, "name": "1.21.1" },
  "motd": {
    "raw": ["§aHello"],
    "clean": ["Hello"],
    "html": ["<span style=\"color:#55FF55\">Hello</span>"]
  },
  "players": { "online": 12, "max": 100, "list": [{ "name": "Steve", "uuid": "..." }] },
  "icon": "data:image/png;base64,...",
  "debug": { "ping": true, "query": true, "srv": true, "cachehit": false, "apiversion": 1 }
}

CORS

All API responses include Access-Control-Allow-Origin: * so you can call them from browser apps.