Public, read-only server data. No API key is required. Third-party clients may use these endpoints with CORS. Fair-use limit: 120 requests per minute per IP by default.
Download the OpenAPI 3.1 specification
GET /v1/skins/{uuid} — one player's current skin as a texture hashSuccessful responses contain apiVersion, realmId, data and meta. Use meta.readAt as the database query time, not the last in-game update. Cached responses keep the original timestamp. Zero and an empty array are real results; unavailable data returns an error instead.
BIGINT counters and metric values are decimal strings. Playtime is stored milliseconds. Leaderboard position is the list position, not a competition rank shared by tied players. Treat text as plain text, never HTML.
Support ETag/If-None-Match. On HTTP 429 or 503, back off; respect Retry-After. Please poll at most once per 30–60 seconds. No personal-name search, raw database endpoints or admin actions are exposed.
Every player object has uuid, name and skin. skin is the player's current SkinsRestorer skin as a lowercase textures.minecraft.net hash, for example for https://textures.minecraft.net/texture/{skin} or an avatar service. It is null when no skin is known: online and Bedrock players without a set skin use their own profile, and a temporarily unavailable skin source never fails the response. No skin values, signatures or source URLs are published.
Missing Nexus data is NOT_READY, not a fabricated empty network. Travel counts are not currently recorded. Anonymous contributor names and UUIDs are never returned. Status probeTimeExact=false means the timestamp was obtained from a separate recent-probe endpoint, not atomically with the player count.