Distribution

List players served

Every player a bound server has handed the pack to, one row per player per server, most recently seen first, with their join counts. This is who the plan's player allowance counts. Page with nextOffset until it is null.

GET/packs/{pack}/distribution/players

Path parameters

packstringrequired

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

Query parameters

limitinteger1–100default 25

How many to return.

offsetintegermin 0default 0

From the previous response's nextOffset.

Response · 200

One page of players.

packstringrequired

The pack.

playersarray of objectrequired

Most recently seen first.

uuidstringrequired

The player's UUID.

ignstringrequired

Their name, when the server said.

serverstringrequired

The id of the server that served them.

platformstringrequired

java or bedrock, when known.

minecraftVersionstringrequired

The version they were last on, when it could be placed.

outcomestringrequired

What their client did the last time.

Options: pending, accepted, declined, failed, unsupported

joinsintegerrequired

Times they were served.

acceptedintegerrequired

Times their client loaded it.

declinedintegerrequired

Times they declined it.

failedintegerrequired

Times the download failed.

firstSeenAtstringrequired

ISO 8601.

lastSeenAtstringrequired

ISO 8601.

nextOffsetintegerrequired

The offset for the next page, or null at the end.

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.