MCSRVSTAT API

Check Minecraft Java and Bedrock status over HTTP. The API returns v3-compatible JSON.

Server status

Java: /3/<address>

Bedrock: /bedrock/3/<address>

Use the same-origin proxy on the website:

/api/status?address=sv.minefc.com&edition=java

Replace edition=java with edition=bedrock to check Bedrock servers. Addresses accept hostnames, IPv4 or bracketed IPv6, with an optional port.

Response

{
  "online": true,
  "ip": "203.0.113.10",
  "port": 25565,
  "version": "1.21",
  "latency_ms": 42,
  "motd": {
    "raw": [
      "§aChào mừng đến server Việt Nam"
    ],
    "clean": [
      "Chào mừng đến server Việt Nam"
    ],
    "html": [
      "<span style=\"color:#55ff55\">Chào mừng đến server Việt Nam</span>"
    ]
  },
  "players": {
    "online": 12,
    "max": 100
  }
}

Optional fields appear only when the server provides them. Offline servers return online: false along with the IP, port and debug information.

Debug values

Field	Description
`ping`	Received a Java Server List Ping response.
`query`	Received a Query UDP response.
`bedrock`	Received a Bedrock RakNet response.
`srv`	An SRV record was used.
`cachehit`	The result was served from cache.
`cachetime / cacheexpire`	Cache creation and expiration time, in UNIX seconds.
`latency_ms`	Latency measured from the API host, in milliseconds.

Server icon

Website proxy: /api/icon?address=<address>. Standalone API: /v1/icon/<address>.

Status banner

Use this image URL to embed a server status banner:

/api/banner?edition=java&address=sv.minefc.com

Choose java or bedrock. The image is cached and may not update immediately.

Connection diagnostics

Offline status responses may include debug.error_ping with a diagnostic code. DNS and API failures return an error code instead of reporting the server as offline.

TIMEOUT, CONNECTION_REFUSED, NETWORK_UNREACHABLE, INVALID_RESPONSE, DNS_NOT_FOUND, DNS_TEMPORARY

Errors

Invalid addresses return 400, blocked targets return 403, and rate limits return 429. For connection errors, check that the API is running and API_BASE_URL is configured.