Game

Query MC Bedrock Server

0calls
1 credits / call

Want to monitor a Minecraft Bedrock Edition server's status in real time? Bedrock Edition uses a completely different underlying network protocol (RakNet) from Java Edition, so querying it works differently. This endpoint is built specifically for Bedrock server monitoring and latency checks.

GET
uapis.cn
/api/v1/game/minecraft/bedrockstatus
Query parameters
1
server
string
required

The Bedrock server address, supporting either a domain or an IP:port format. If the port is omitted, the standard Bedrock port 19132 is used by default.

Overview

Just provide a Bedrock server address (domain or IP) to get its real-time online status. Besides the usual player count, max players, and protocol version, it also returns Bedrock-specific fields such as the dual-line MOTD (main title and subtitle), game mode (e.g. Survival), and the server's unique GUID.

Offline and omitted fields When the target server is offline or unreachable, the response body will only contain online: false, and all other fields will be omitted. Make sure your frontend code handles missing fields gracefully.

Latency measurement The latency_ms value in the response represents the network round-trip time measured from the cloud API server to the target server. It is for reference only and does not represent the actual in-game latency an end user would experience connecting directly.

Query parameters

server
stringrequired

The Bedrock server address, supporting either a domain or an IP:port format. If the port is omitted, the standard Bedrock port 19132 is used by default.

Response

200 / OK

Query successful! Returns detailed status information for the Bedrock server. If the server is offline, only { "online": false } will be returned.

JSON
{
  // Whether the server is currently online. When false, no other fields are returned.
  "online": true,
  // The IP address the server domain resolved to.
  "ip": "139.99.123.79",
  // The Bedrock port actually queried.
  "port": 19132,
  // Server edition identifier. MCPE indicates Bedrock Edition, MCEE indicates Education Edition.
  "edition": "MCPE",
  // The version string reported by the server. Note: some servers may replace this field with arbitrary advertising text.
  "version": "1.26.44",
  // The underlying Bedrock network protocol version number.
  "protocol": 2168,
  // Current number of online players.
  "players": 5059,
  // The server's configured maximum player capacity (large servers often inflate this value to appear more popular).
  "max_players": 15059,
  // HTML-rendered format of the first MOTD line, with embedded color codes converted to inline styles for direct frontend rendering.
  "motd_html": "🌧 SKYBLOCK & ONEBLOCK ⛈",
  // Plain text format of the first MOTD line.
  "motd_clean": "🌧 SKYBLOCK & ONEBLOCK ⛈",
  // HTML-rendered format of the Bedrock-specific second MOTD line (may be empty on some servers).
  "sub_motd_html": "C",
  // Plain text format of the second MOTD line.
  "sub_motd_clean": "C",
  // The server's default game mode.
  "gamemode": "Survival",
  // The server's unique GUID, returned as a string to avoid JavaScript large-integer precision loss.
  "server_guid": "12484560144851717283",
  // The IPv4 port broadcast by the server (some servers may not return this field).
  "port_v4": 19132,
  // The IPv6 port broadcast by the server (some servers may not return this field).
  "port_v6": 19132,
  // Network round-trip time from the cloud API server to the target server, in milliseconds.
  "latency_ms": 238
}

400 / Bad Request

Invalid request parameter or the address could not be resolved.

JSON
{
  "code": "INVALID_PARAMETER",
  "message": "Target address is not allowed to be queried"
}

500 / Internal Server Error

Internal server error, the query service is temporarily unavailable.

JSON
{
  "code": "INTERNAL_ERROR",
  "message": "Game service query failed"
}