Skip to content

DevelopersReference

Game modes

Every game mode slug the modes filter takes, with live servers and players (refreshed every 5 minutes).

GET/api/v1/minecraft/modes
Bucket meta60/min with a key · 20 withoutCached 5 minKey optional

Response

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

modesobject[]4 fields
slugstring
labelstring
serversOnlineinteger
playersOnlineinteger

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.