Minecraft

Ping/query a Minecraft server to get online status and info.

Certain servers shown as fullQuery: true can show the player list.

GEThttps://api.fluxpoint.dev/mc/ping

Authorization

key

Query parameters

Header parameters

Response

200400401403

Success

Body

application/json

onlineboolean

rawIconnullable string

iconnullable string

motdnullable string

playersOnlineinteger (int32)

playersMaxinteger (int32)

versionnullable string

fullQueryboolean

playersnullable array of string

messagenullable string

successboolean

codeinteger (int32)

Request

JavaScriptCurlPythonHTTP

const response = await fetch('https://api.fluxpoint.dev/mc/ping?host=', {
    method: 'GET',
    headers: {
      "Authorization": "key <apiKey>"
    },
});
const data = await response.json();

Response

200400401403

{
  "online": true,
  "rawIcon": "",
  "icon": "https://eu.mc-api.net/v3/server/favicon/mc.hypixel.net:25565.png",
  "motd": "Hypixel Network [1.8-1.20]\n     NEW PTL GAME: SHEEP WARS | SB 0.20.1",
  "playersOnline": 27973,
  "playersMax": 200000,
  "version": "MC 1.8 / 1.20",
  "fullQuery": false,
  "players": [
    "text"
  ],
  "message": "",
  "success": true,
  "code": 200
}

Minecraft Server Ping

GET https://api.fluxpoint.dev/mc/ping

Get the status of a minecraft server.

Query Parameters

Name	Type	Description
host*	String	The ip of the server to ping.
port	String	Optional port to use (defaults to 25565)
icon	Bool	Set this to true to get the raw server icon in base64 (Defaults to false)

Headers

Name	Type	Description
Authorization*		Your API token here https://fluxpoint.dev/api/token

200: OK

If fullQuery is false then the server does not allow listing player.

{
	"online": true,
        "rawIcon": "base64", // This is empty by default
	"icon": "https://eu.mc-api.net/v3/server/favicon/mc.hypixel.net:25565.png",
	"motd": "Hypixel Network [1.8-1.19]\n    HOLIDAYS EVENT | DOUBLE COINS AND EXP",
	"playersOnline": 43088,
	"playersMax": 100000,
	"version": "MC 1.8 / 1.19",
	"fullQuery": false,
	"players": [],
	"success": true,
	"code": 200,
	"message": ""
}

Minecraft Player UUID Lookup

GET https://api.fluxpoint.dev/mc/uuid

Get a Minecraft player UUID from player name.

Query Parameters

Name	Type	Description
player*	String	Account name to lookup

Headers

Name	Type	Description
Authorization*	String	Your API token here https://fluxpoint.dev/api/token

200: OK

{
    "accountFound": true,
    "uuid": "1e227d4e239748eab0ab19b1de70833f",
    "name": "xXBuilderBXx"
}

Minecraft Player Skin

GET https://api.fluxpoint.dev/mc/skin

Get the skin image of a Minecraft player account.

Query Parameters

Name	Type	Description
player*	String	Account name to lookup
type	String	Type of skin image (head, cube, body, full, all) defaults to full

Headers

Name	Type	Description
Authorization*		Your API token here https://fluxpoint.dev/api/token

200: OK

{
    "accountFound": true,
    "uuid": "1e227d4e239748eab0ab19b1de70833f",
    "name": "xXBuilderBXx",
    "skinUrl": ""
}

If you use type=all then it will return all skin images.

{
    "accountFound": true,
    "uuid": "1e227d4e239748eab0ab19b1de70833f",
    "name": "xXBuilderBXx",
    "headUrl": "",
    "cubeUrl": "",
    "bodyUrl": "",
    "fullUrl": ""
}