You can use minecraftuuid.com to find the UUID of a username.
Accepted modifiers: size, overlay, default.
Accepted modifiers: scale, overlay, default.
Accepted modifiers: scale, overlay, default.
Accepted modifiers: default.
Accepted modifiers: default.
You can append .png
or any other file extension to the URL path if you like to, but all images are PNG.
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:
Thank you to <a href="https://crafatar.com">Crafatar</a> for providing avatars.
You can tweak images using query string parameters.
Example: https://crafatar.shotbow.eu/avatars/853c80ef3c3749fdaa49938b674adae6?size=4&default=MHF_Steve&overlay
1 - 512
1 - 10
true
. This option was previously known as helm
.
MHF_Steve
/MHF_Alex
.MHF_Steve
or MHF_Alex
, depending on Minecraft's default for the requested UUID.
UUIDs may be any valid Mojang UUID in the blank or dashed format.
Malformed UUIDs are rejected.
By disabling a legacy API in 2018, Mojang has made it practically impossible for Crafatar to support usernames. Please use UUIDs instead!
All usernames are rejected.
Crafatar checks for skin updates every 20 minutes.
Images are also cached in your browser for 60 minutes unless you clear your browser cache.
After changing your Minecraft skin, you can try clearing your browser cache to see the change faster.
Crafatar supports Cross-Origin Resource Sharing, so you can make AJAX request from other sites!
Crafatar always replies with a 200 OK
status code when the requested user's skin/cape was found. This is also used in some rare cases when Mojang servers are having issues and the image couldn't be checked for changes, but Crafatar still had a cached version.
502 Bad Gateway
and 500 Server Error
are used when no skin/cape was found because of Mojang or Crafatar server issues.
Note that requests are usually answered with an image (with Steve/Alex skin), even if an error occured!
Responses come with some HTTP headers that are useful for debugging.
110 Crafatar "Response is Stale"
111 Crafatar "Revalidation Failed"
See all quotes.