0 Avatars served


Craftathon is a fun-filled weekend-long Minecraft charity event where popular Minecraft community members can come together to play online with their fans. This year, Craftathon will be supporting Child's Play Charity, improving the lives of children in domestic violence shelters and hospitals.

100% of all the donated funds go directly to Child's Play Charity!
Some of the special guests include: JeromeASF, BlackBeltPanda, HomieDolphin and many more!
Come join us for the weekend long event to support the cause and help raise money for the fund!

Extremely simple avatars

The examples shown below work with all avatar types.

For basic usage just provide a UUID or a username:
For size control, add the desired size in pixels after specifying the username:
For avatars without the helm element, add /nohelm to the end of any URL:
And for a URL with a file extension, you can add a .png at the very end of any URL:

8px up to 600px

Isometric Head


32px up to 600px

Isometric Body


32px up to 600px

Full body


8px up to 600px

Combo avatar


8px up to 600px


If the player does not own a cape, an HTTP/1.1 404 Not Found status code will be returned.

Default skins:


Get skin:


Download skin:


Direct skin switch:


Mojang API:

This option caches requests to the mojang api letting you request a profile without a rate limit. It also displays the account's username history and username change count
Profiles currently cache for 15 minutes.
https://mc-heads.net/minecraft/profile/[username or UUID]
If username/UUID is malformed, an HTTP/1.1 204 No content status code will be returned.

About Caching

MCHeads caches skins for 36 hours
Images are also cached in your browser for 36 hours until a new request to MCHeads is made.

If you changed your skin you can try clearing your browser cache to see the change faster.
MCHeads deletes expired server side cache every 5 minutes.

About Usernames

We strongly advise you to use UUIDs instead of usernames! UUIDs never change while usernames do.
Looking up players by username has officially been deprecated by Mojang ever since UUIDs were introduced.

Malformed usernames are rejected.

About UUIDs

UUIDs may be any valid Mojang UUID in the blank or dashed format.
Malformed UUIDs are rejected, and all features on MCHeads support UUIDs


MCHeads supports Cross-Origin Resource Sharing, so you can make AJAX request from other sites!


Attribution is not required, but it is encouraged.
If you want to show some support for this (free!) service, place a notice like this somewhere: Thanks to <a href="https://mc-heads.net">MCHeads</a> for providing Minecraft avatars.

HTTP Headers

Responses come with some custom HTTP headers, useful for debugging.
Please note that these headers may be cached by CloudFlare.

  • X-Has-Failed: Details about the request status
    • true: The request went well, there were no issues on both sides.
    • false: couldn't reach mojang's services or a malfored UUID/Name was requested.


To contact us about any issue, please send an E-Mail to support@mc-heads.net, or ask in our Discord server.

MCHeads © 2013 - 2018 – All rights reserved

Back to top