Servers by Version

Overview Authentication Endpoints Rate Limiting Examples
GET /servers/versions

Retrieves a list of unique Minecraft server versions and the number of servers running each version. Results are sorted by server count in descending order (most popular versions first).

Authentication

None required

Query Parameters

Parameter Type Required Default Description
version string No - Filter by server version. Supports * as wildcard (e.g., 1.20* to match all 1.20.x versions)
limit integer No - Maximum number of results to return. Must be between 1 and 999

Example Requests

Get all server versions:

GET /api/v0.1/servers/versions

Example Response

{
  "unique_versions": 15,
  "versions": [
    {
      "num_servers": 2341,
      "version": "1.20.1"
    },
    {
      "num_servers": 1876,
      "version": "1.19.2"
    },
    {
      "num_servers": 1654,
      "version": "1.20.4"
    },
    {
      "num_servers": 987,
      "version": "1.18.2"
    },
    {
      "num_servers": 765,
      "version": "1.21"
    },
    {
      "num_servers": 543,
      "version": "1.17.1"
    },
    {
      "num_servers": 412,
      "version": "latest"
    },
    {
      "num_servers": 234,
      "version": "1.16.5"
    }
  ]
}

Response Fields

Field Type Description
unique_versions integer Total number of unique Minecraft versions
total_servers integer Total number of servers across all versions
versions array Array of version objects
versions[].num_servers integer Number of servers running this version
versions[].version string Minecraft version string (e.g., "1.20.1")