Distribution

Read distribution numbers

The Distribution tab's numbers: how many players bound servers have handed the pack to, how often, what their clients did with it, which versions they were on, and serves per day.

unsupported counts joins on a version the release was not built for: add that version with POST /packs/{pack}/distribution and publish again. unknownProtocols is a client too new for us to name yet. Every figure is all-time except daily.

GET/packs/{pack}/distribution/stats

Path parameters

packstringrequired

The pack's slug, as returned by the packs endpoints.

Query parameters

daysinteger1–90default 30

How many days daily covers, ending today.

Response · 200

The numbers.

packstringrequired

The pack.

playersintegerrequired

Unique players served, which is what the plan's player allowance counts.

servesintegerrequired

Times the pack was handed to a player.

acceptedintegerrequired

Serves the player's client accepted and loaded.

declinedintegerrequired

Serves the player declined.

failedintegerrequired

Serves whose download failed in the client.

unsupportedintegerrequired

Joins on a version the release was not built for, so nothing was served.

byVersionarray of objectrequired

Serves per Minecraft version the players were on.

versionstringrequired

The version, or null when the client could not be placed.

servesintegerrequired

Serves on it.

unknownProtocolsarray of objectrequired

Clients reporting a protocol number we cannot map to a version yet.

protocolintegerrequired

The protocol number.

servesintegerrequired

Serves with it.

dailyarray of objectrequired

Serves per day, oldest first, empty days included.

daystringrequired

YYYY-MM-DD, UTC.

servesintegerrequired

Serves that day.

Error codes

Branch on error.code, never on the message.

invalid_api_key401

The key isn't one of ours, or it has been revoked.

missing_api_key401

No Authorization: Bearer header was sent.

wrong_key_kind401

An MCP key sent to the REST API, or an API key sent to the MCP server. Each only opens its own.

account_suspended403

The account is suspended, so its keys open nothing. message says until when, if the suspension has an end date.

plan_required403

The key is valid, but its account's plan does not include the API.

not_found404

No such pack, asset or job.