Game

Query MC Player

0calls
1 credits / call

With just a player's username, you can quickly get their premium skin and unique UUID!

GET
uapis.cn
/api/v1/game/minecraft/userinfo
Query parameters
1
username
string
required

Player's Minecraft in-game name (premium ID).

Overview

This is a basic but very practical endpoint. With a player's current in-game name (Username), you can query their corresponding UUID (unique identifier) and current skin URL address. This is the first step in building many other player-related services.

Query parameters

username
stringrequired

Player's Minecraft in-game name (premium ID).

Response

200 / OK

Query successful! Returns user's UUID and skin link.

JSON
{
  // URL of the player's currently used skin image.
  "skin_url": "http://textures.minecraft.net/texture/292009a499420915b854a9913d9fa92750175814529452a55982791844863f53",
  // Player's current accurate username (note that case may differ from input).
  "username": "Notch",
  // Player's 32-character UUID without dashes.
  "uuid": "ee9b4ed1aac1491eb7611471be374b80"
}

400 / Bad Request

Request failed. Please check if you provided the username parameter.

JSON
{
  "code": "INVALID_ARGUMENT",
  "details": {},
  "message": "Missing 'username' parameter."
}

404 / Not Found

Player not found. Based on the username you provided, we couldn't find the corresponding Minecraft player. Please check if the spelling is correct.

JSON
{
  "code": "NOT_FOUND",
  "details": {},
  "message": "Player with the specified username not found."
}

502 / Bad Gateway

Unable to fetch game data temporarily, please try again later.

JSON
{
  "code": "UPSTREAM_ERROR",
  "details": {},
  "message": "Unable to fetch game data. Please try again later."
}