Query Player

GET /player/(query)

Retrieve information about a player by looking up their username or UUID.

View the Swagger Docs for more.

Path Variables

Name	Type	Description
query	string	`Username or UUID`

Query Parameters

Name	Type	Default	Content
signed	boolean	`false`	`Whether the player profile is signed by Mojang`

Error Codes

Code	Description
`400 (BAD_REQUEST)`	The given UUID or username is invalid
`404 (NOT_FOUND)`	The requested player couldn't be found
`429 (TOO_MANY_REQUESTS)`	The Mojang API rate limit has been reached

Cache

Results are cached for up to 1 hour

Response

{
    "uniqueId": "fc1d5fe7-f29b-430d-80bb-3b093a638b0f",
    "username": "Rainnny",
    "skin": {
        "url": "http://textures.minecraft.net/texture/ac8db1928dc94e332cca7be9567c7bbf4c56563000667d3a58ade257cde34f82",
        "model": "SLIM",
        "legacy": false,
        "parts": {
            "HEAD": "https://api.restfulmc.cc/player/head/fc1d5fe7f29b430d80bb3b093a638b0f.png"
            ...
        }
    },
    "cape": {
        "url": "http://textures.minecraft.net/texture/2340c0e03dd24a11b15a8b33c2a7e9e32abb2051b2481d0ba7defd635ca7a933"
    },
    "properties": [
        {
            "name": "textures",
            "value": "ewogICJ0aW1lc3RhbXAiIDog…TMzIgogICAgfQogIH0KfQ==...",
            "signed": false
        }
    ],
    "legacy": false,
    "cached": 1713023287371 // -1 if not cached
}