GET/head/{player}
Player head (default 128px)
https://skins.olivr.cc/head/Notch
Documentation
Complete reference for the MC Heads API endpoints.
Parameters
{player}
Username, UUID, or XUID. For Bedrock players, prefix with a dot (e.g., .PlayerName)
{size}
Image size in pixels (16–512, default 128)
{direction}
left or right (avatar, 3D head, and iOS routes)
Renders
/avatarGET/head/{player}/{size}
Player head with custom size
https://skins.olivr.cc/head/Notch/64
GET/head/{player}/{size}/hat
Player head with hat overlay
https://skins.olivr.cc/head/Notch/64/hat
GET/bust/{player}
Bust render — head, torso, and arms
https://skins.olivr.cc/bust/Notch
GET/bust/{player}/{size}
Bust render with custom size. Add /hat for overlays.
https://skins.olivr.cc/bust/Notch/128/hat
GET/head3d/{player}/{direction}
Isometric 3D head (left or right)
https://skins.olivr.cc/head3d/Notch/right
GET/head3d/{player}/{direction}/{size}
Isometric 3D head with custom size
https://skins.olivr.cc/head3d/Notch/left/128
GET/avatar/{player}/{direction}
Player avatar (left or right)
https://skins.olivr.cc/avatar/jeb_/left
GET/avatar/{player}/{direction}/{size}
Player avatar with custom size
https://skins.olivr.cc/avatar/jeb_/right/128
GET/player/{player}
Full player body
https://skins.olivr.cc/player/Dinnerbone
GET/player/{player}/{size}
Full player body with custom size. Add /hat for overlays.
https://skins.olivr.cc/player/Dinnerbone/256
GET/skin/{player}
Raw skin texture
https://skins.olivr.cc/skin/Notch
iOS
GET/ioshead/{player}/{direction}/{size}
iOS-optimized head (left/right)
https://skins.olivr.cc/ioshead/Notch/left/512
GET/iosbody/{player}/{direction}/{size}
iOS-optimized body (left/right)
https://skins.olivr.cc/iosbody/Notch/right/512
Data
GET/health
API health status
https://skins.olivr.cc/health
GET/allstats
Java edition statistics
https://skins.olivr.cc/allstats
GET/allstatsbedrock
Bedrock edition statistics
https://skins.olivr.cc/allstatsbedrock
GET/minecraft/mhf
MHF head list
https://skins.olivr.cc/minecraft/mhf
Download
GET/download/{player}
Download skin file
https://skins.olivr.cc/download/Notch
Examples
HTML
<img src="https://skins.olivr.cc/head/Notch/64" alt="Notch" />
JavaScript
fetch('https://skins.olivr.cc/avatar/Notch/left/128')
.then(res => res.blob())
.then(blob => {
// Use the image blob
});
Bedrock Player
https://skins.olivr.cc/head/.BedrockPlayer/128