Skip to main content
GET
/
v1
/
query
/
minecraft
Query Minecraft server
curl --request GET \
  --url https://api.waterfall.host/v1/query/minecraft \
  --header 'Authorization: Bearer <token>'
{
  "online": true,
  "host": "mc.hypixel.net",
  "port": 25565,
  "resolvedFrom": "srv",
  "players": {
    "online": 45234,
    "max": 100000,
    "list": [
      "Player1",
      "Player2"
    ]
  },
  "version": "1.8.9-1.21.4",
  "motd": "Hypixel Network [MVP++]",
  "latency": 42
}

Authorizations

​
Authorization
string
header
required

API key generated from your Waterfall dashboard

Query Parameters

​
host
string
required

Server hostname or IP address (e.g., mc.hypixel.net, play.example.com)

​
port
integer
default:25565

Server port (default: 25565). Note: SRV records will override this value.

Required range: 1 <= x <= 65535

Response

Server is online and responding

​
online
boolean
Example:

true

​
host
string
Example:

"mc.hypixel.net"

​
port
integer
Example:

25565

​
resolvedFrom
enum<string>
Available options:
srv,
a,
direct
Example:

"srv"

​
players
object
​
version
string
Example:

"1.8.9-1.21.4"

​
motd
string
Example:

"Hypixel Network [MVP++]"

​
latency
integer

Round-trip time in milliseconds

Example:

42