Minecraft

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

get

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

Authorizations

key

AuthorizationstringRequired

You need to purchase API access at https://fluxpoint.dev/api

Query parameters

hoststringRequired

Enter the Minecraft server ip/domain/host to query

Default: ""

portstringOptional

Not required unless the server uses a custom port

Default: 25565

iconbooleanOptional

Not required unless you want the raw image data of the server

Default: false

Header parameters

AuthorizationanyRequired

Responses

200

Success

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

get

/mc/ping

HTTPcURLJavaScriptPython

GET /mc/ping?host= HTTP/1.1
Host: api.fluxpoint.dev
Authorization: YOUR_API_KEY
Accept: */*

{
  "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": ""
}