Reference
Best-in-class docs for Minecraft API work.
MC Utils gives you Java and Bedrock lookups, renders, metrics, account flows, and live examples in one place. Every endpoint below is documented with real request shapes and copy-ready code.
33Documented endpoints
JSON + PNGResponse formats
Live demoRun public requests instantly
Quick start
curl "https://util.axolite.app/v1/player/Notch"Response
{
"uuid": "069a79f4-44e9-4726-a5be-fca90e38aaf5",
"name": "Notch",
"skin_url": "https://textures.minecraft.net/texture/...",
"cape_url": null,
"slim": false
}Endpoint index
| Method | Path | Description |
|---|---|---|
| GET | / | JSON root endpoint with service metadata, links, and a quick endpoint index. |
| GET | /health | Returns the current service health for database, Redis, storage configuration, and version. |
| GET | /v1/player/:identifier | Resolve a Java username or UUID into a profile with skin, cape, and model metadata. |
| GET | /v1/player/:identifier/uuid | Resolve a username or UUID into the current canonical UUID and player name. |
| GET | /v1/player/:identifier/username | Resolve a UUID or username into the current Java username. |
| GET | /v1/player/:identifier/history | Returns historical name data when available plus a note about Mojang history limitations. |
| POST | /v1/player/batch | Resolve up to 10 Java usernames in one POST request. |
| GET | /v1/render/head/:identifier | Render a Java head PNG with pixel-perfect scaling and cache headers. |
| GET | /v1/render/face/:identifier | Render a Java face PNG with pixel-perfect scaling and cache headers. |
| GET | /v1/render/bust/:identifier | Render a Java bust PNG with pixel-perfect scaling and cache headers. |
| GET | /v1/render/body/:identifier | Render a Java body PNG with pixel-perfect scaling and cache headers. |
| GET | /v1/render/avatar/:identifier | Render a Java avatar PNG with pixel-perfect scaling and cache headers. |
| GET | /v1/render/skin/:identifier | Render a Java skin PNG with pixel-perfect scaling and cache headers. |
| GET | /v1/render/cape/:identifier | Render a Java cape PNG with pixel-perfect scaling and cache headers. |
| GET | /v1/render/download/:identifier | Download the original Java skin PNG with a filename based on the player name. |
| GET | /v1/bedrock/player/:identifier | Resolve a Bedrock gamertag or XUID into current Bedrock skin metadata. |
| GET | /v1/bedrock/player/:identifier/xuid | Resolve a Bedrock gamertag into an XUID or normalize an existing XUID. |
| GET | /v1/bedrock/render/head/:identifier | Render a Bedrock head PNG through the same pixel renderer used for Java skins. |
| GET | /v1/bedrock/render/bust/:identifier | Render a Bedrock bust PNG through the same pixel renderer used for Java skins. |
| GET | /v1/bedrock/render/body/:identifier | Render a Bedrock body PNG through the same pixel renderer used for Java skins. |
| GET | /v1/bedrock/render/skin/:identifier | Render a Bedrock skin PNG through the same pixel renderer used for Java skins. |
| GET | /v1/metrics | Read the public platform metrics used by the homepage and dashboard surfaces. |
| GET | /v1/stats | Comprehensive lifetime statistics including total requests, renders served, unique players, and cache performance. |
| GET | /v1/ws/metrics | Stream live platform metrics over WebSocket for dashboards and status pages. |
| GET | /v1/ws/feed | Stream a real-time feed of API requests as they happen, perfect for live dashboards and monitoring. |
| GET | /v1/ws/account | Stream account-scoped usage metrics for authenticated dashboards. |
| POST | /v1/auth/login | Send a magic link email to start a passwordless sign-in flow. |
| GET | /v1/auth/verify?token=... | Consume a one-time token, create a session cookie, and redirect the user to the dashboard. |
| POST | /v1/auth/logout | Delete the current session and clear the HttpOnly session cookie. |
| GET | /v1/account | Return the authenticated account profile for the current session. |
| GET | /v1/account/keys | List active API keys for the authenticated account. |
| POST | /v1/account/keys | Create a new API key for the authenticated account. |
| DELETE | /v1/account/keys/:id | Revoke an existing API key by UUID. |