Skip to content

DevelopersMinecraft

A Minecraft server's player history

Average and peak players and uptime per hour or day, both editions combined (a crossplay network counts once). Tracking started 2026-11-12; earlier buckets are null.

GET/api/v1/minecraft/servers/{slug}/history
Bucket history60/min with a key · 10 withoutCached 5 minKey optional

Path parameters

slugrequiredstring

Query parameters

rangeenum
day, week, month or year.dayweekmonthyearDefault "week"
resolutionenum
hour (up to a month) or day. Default: hour for day and week, day for month and year.hourday

Response

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

slugstring
resolutionenum
fromstringISO 8601 time, UTC.
tostringISO 8601 time, UTC.
unitstringWhat "players" counts: players, members online, or servers (bots).
pointsobject[]4 fields
tstringStart of the hour or day.
playersnumber | nullAverage while online; null when it wasn't checked or was offline.
peakinteger | null
uptimenumber | nullShare of checks answered, 0–1; null when it wasn't checked.

Errors

invalid_request400

A query or path parameter is missing or out of range.

not_found404

No public item with that slug.

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.