Skip to content

DevelopersGuides

Status endpoint (v1)

The original keyless status endpoint.

The original endpoint keeps working unchanged: one Minecraft listing's status, 60 requests a minute per IP, cached 30 seconds. New code should use Get a Minecraft server.

Shell
curl https://lobbydex.com/api/v1/servers/example-network

Response

JSON (illustrative)
{
  "slug": "example-network",
  "name": "Example Network",
  "url": "https://lobbydex.com/minecraft/example-network",
  "online": true,
  "players": {
    "online": 1234,
    "max": 5000
  },
  "rank": 42,
  "editions": [
    "java",
    "bedrock"
  ],
  "java": {
    "address": "play.example.net",
    "version": "1.8–1.21"
  },
  "bedrock": {
    "address": "play.example.net:19132",
    "version": "1.21"
  },
  "checkedAt": "2026-11-14T12:00:00.000Z",
  "attribution": "Data from Lobbydex (https://lobbydex.com). Attribution with a link is required."
}
FieldTypeMeaning
slugstringThe listing's id in Lobbydex URLs.
namestringDisplay name.
urlstringThe listing's Lobbydex page. Link to it when you show the data.
onlinebooleanWhether any of the listing's servers answered our latest checks.
players.onlinenumberPlayers online now, each network counted once.
players.maxnumberSlots the server reports.
ranknumber | nullLobbydex rank; null when unranked or the count is unverified.
editionsstring[]"java", "bedrock" or both.
java / bedrockobject | nulladdress (the hostname players type) and version, per edition.
checkedAtstring | nullISO time of our latest check.
attributionstringThe credit line to show.