Skip to content

DevelopersReference

Site totals

Minecraft servers and players online now (crossplay servers count under both editions, so java + bedrock exceeds the total), Discord totals and bots listed.

GET/api/v1/stats
Bucket meta60/min with a key · 20 withoutCached 1 minKey optional

Response

200 OK, JSON. Full schema in openapi.json.

minecraftobject4 fields
serversOnlineinteger
playersOnlineinteger
javaobject2 fields
serversOnlineinteger
playersOnlineinteger
bedrockobject2 fields
serversOnlineinteger
playersOnlineinteger
discordobject2 fields
serversListedinteger
membersOnlineinteger
botsobject1 fields
botsListedinteger
atstringISO 8601 time, UTC.

Errors

invalid_key401

The key is malformed, revoked or unknown. Leave it out to use the anonymous allowance.

rate_limited429

Over a bucket or the global limit. Wait retry_after seconds.

internal_error500

Something broke on our side. Retry with backoff.