Servers by Region

Overview Authentication Endpoints Rate Limiting Examples
GET /servers/regions

Retrieves a list of unique regions where Minecraft servers are located. Results are filtered to only include servers that have been pinged within the last 30 days and sorted alphabetically by region name.

Authentication

None required

Query Parameters

Parameter Type Required Description
region string No Filter by region name. Accepts * as a wildcard for partial matching (e.g., us-* to match all US regions)

Example Requests

Get all regions:

GET /api/v0.1/servers/regions

Filter by region name (with wildcard):

GET /api/v0.1/servers/regions?region=us-*

Example Response

{
  "unique_regions": 12,
  "total_servers": 4521,
  "regions": [
    {
      "num_servers": 1234,
      "region": "us-east"
    },
    {
      "num_servers": 987,
      "region": "us-west"
    },
    {
      "num_servers": 756,
      "region": "eu-west"
    },
    {
      "num_servers": 645,
      "region": "eu-central"
    },
    {
      "num_servers": 512,
      "region": "ap-southeast"
    },
    {
      "num_servers": 387,
      "region": "ap-northeast"
    }
  ]
}

Response Fields

Field Type Description
unique_regions integer Total number of unique regions
total_servers integer Total number of servers across all regions
regions array Array of region objects
regions[].num_servers integer Number of servers in that region
regions[].region string Region name identifier