Public API

Endpoint

GET https://api.minecraftpinger.com/<host>:<port>

Port is optional and defaults to 25565 (Java) or 19132 (Bedrock). Both Java Edition and Bedrock Edition servers are supported.

https://api.minecraftpinger.com/hypixel.nethttps://api.minecraftpinger.com/hypixel.net:25565https://api.minecraftpinger.com/play.cubecraft.net:19132

Required Header

User-Agent: your-app/1.0

All requests must include a User-Agent header identifying your application. This lets us understand how the API is being used and helps us contact you if something goes wrong. Requests without a User-Agent are rejected with a 400 response.

Response

Online server

{
  "message": "ok",
  "server": {
    "ip": "hypixel.net",
    "port": 25565,
    "players": {
      "online": 52847,
      "max": 200000
    },
    "motd": "Hypixel Network [1.8-1.21]",
    "version": "Requires MC 1.8 / 1.21",
    "ping": 23,
    "edition": "java",
    "favicon": "data:image/png;base64,..."
  }
}

Offline or unreachable server

{
  "message": "ok",
  "server": null
}

Caching

Responses are cached at the CDN edge for 5 minutes. Repeated requests for the same server within that window return the cached result instantly without hitting the origin. You can check the CF-Cache-Status response header to see whether a response was served from cache (HIT) or freshly fetched (MISS).