Skins

Download a skin

The skin's 64x64 PNG, the file Minecraft and every skin site take. Asking before it is drawn answers still_generating.

GET/skins/{skin}/file

Path parameters

skinstringrequired

The skin's id.

The PNG.

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.

forbidden403

Valid key, but not permitted to do this in this pack.

plan_required403

The key is valid, but its account is on Starter. The API needs a paid plan.

not_found404

No such pack, asset or job.

generation_failed409

That asset's generation failed. Its job carries the reason.

still_generating409

The asset exists but isn't finished. Poll its job until it's ready.