Basic Information

Request

GET http://mcapi.de/api/server/<ip>(/<port>(/<version>))

Parameter List

Parameter Description Allowed Values Example Required
ip The IP address of the server. Every valid IP address or hostname. play.hivemc.eu Yes
port The port of the server. Every valid port. 25565 No (Default: 25565)
version The version of the server. 1.7.*, 1.8.*, 1.9.* 1.8.2 No (Default: 1.9)

Example Result

{
    "result": {
        "status": "Ok",
        "message": "No errors."
    },
    "hostname": "play.hivemc.eu",
    "players": {
        "max": ​20000,
        "online": ​4594
    },
    "updated": {
        "time": "2016-04-03 14:26:09",
        "expires": "2016-04-03 14:31:09",
        "zone": "Europe/Berlin"
    }
}

Complex Information

Request

POST http://mcapi.de/api/server

Parameter List

Parameter Description Allowed Values Example Required
ip The IP address of the server. Every valid IP address or hostname. play.hivemc.eu Yes
port The port of the server. Every valid port. 25565 No (Default: 25565)
version The version of the server. 1.7.*, 1.8.*, 1.9.* 1.8.2 No (Default: 1.9)

Example Result

{
    "result": {
        "status": "Ok",
        "message": "No errors."
    },
    "blocked": {
        "status": false,
        "information": "https://help.mojang.com/customer/portal/articles/1647288-servers-that-violate-commercial-use-guidelines"
    },
    "hostname": "play.hivemc.eu",
    "software": {
        "name": "BeeCord",
        "version": 1.8
    },
    "protocol": 109,
    "players": {
        "max": 20000,
        "online": 4594
    },
    "list": {
        "motd": {
            "extra": [
                {
                    "text": "        "
                },
                {
                    "color": "yellow",
                    "text": "◄"
                },
                {
                    "color": "gold",
                    "text": "▮"
                },
                {
                    "color": "gold",
                    "bold": true,
                    "text": "Rush"
                }
            ],
            "text": ""
        },
        "favicon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAEAAAABACAMAAACdt4HsAAADAFBMVEUAA[...]",
        "ping": 38
    },
    "updated": {
        "time": "2016-04-03 14:26:09",
        "expires": "2016-04-03 14:31:09",
        "zone": "Europe/Berlin"
    }
}

Query

Request

GET http://mcapi.de/api/server-query/<ip>(/<port>)

Parameter List

Parameter Description Allowed Values Example Required
ip The IP address of the server. Every valid IP address or hostname. play.hivemc.eu Yes
port The port of the query. Every valid port. 25565 No (Default: 25565)

Example Result

{
    "result": {
        "status": "Ok",
        "message": "No errors."
    },
    "hostname": "localhost",
    "software": {
        "name": "CraftBukkit on Bukkit 1.9.2-R0.1-SNAPSHOT",
        "version": "1.9.2",
        "plugins": [
            "Example 1.1",
            "Example 1.0"
        ]
    },
    "players": {
        "max": 20,
        "online": 1,
        "list": [
            "Yonas",
            "Notch"
        ]
    },
    "list": {
        "motd": "A Minecraft Server"
    },
    "map": "world"
}