Server Status API

Integration-ready REST API endpoints to fetch live metadata from any Minecraft Java or Bedrock edition server.

Available Endpoints

Java Edition

Standard status for Minecraft Java Edition servers using the handshake protocol.

GET https://srvstat.minespark.org/general/{ip}

Bedrock Edition

RakNet-based status for Bedrock, Pocket Edition, and Education Edition servers.

GET https://srvstat.minespark.org/bedrock/{ip}

Schema Definition

Field	Type	Description
`online`	boolean	Returns true if the server responded.
`hostname`	string	The target address used in the request.
`ip`	string	The IPv4 address of the physical server host.
`port`	integer	The connection port detected.
`motd.clean`	array	Array of description lines without color codes.
`players.online`	integer	Current player count on the network.
`version`	string	The specific Minecraft version reported.
`debug.ping`	boolean	Indicates if a basic socket ping succeeded.

JSON Response Example

{
  "hostname": "play.battlepie.net",
  "ip": "172.65.189.16",
  "online": true,
  "version": "1.21.11",
  "players": {
    "online": 546,
    "max": 9999
  },
  "motd": {
    "clean": [
      "BATTLEPIE | [1.21+]",
      "LIFESTEAL NEW SEASON OUT!"
    ]
  },
  "debug": {
    "ping": true,
    "bedrock": false
  }
}