Mojang

App · Gaming · 7 actions

Look up Minecraft players and public game data through Mojang's official public API: resolve usernames to UUIDs (and back), bulk-resolve up to 10 usernames at once, fetch a player's profile with skin and cape textures, list Mojang's blocked servers, and read Mojang's signing public keys. No account or API key required.

Actions

ActionWhat it does
Get blocked serversGet Mojang's list of blocked server hashes.
Get player profileGet a player's profile by UUID, including the base64-encoded textures property (skin and cape).
Get player skin & capeGet a player's skin and cape as ready-to-use image URLs, decoded from their profile: the skin URL and model (classic or slim), and the cape URL if they have one.
Get public keysGet Mojang's public keys, used to verify signed profile properties, player chat certificates, and authentication data.
Get username by UUIDLook up a Minecraft player's current username from their UUID (dashed or undashed).
Get UUID by usernameLook up a Minecraft player's UUID (and canonical name casing) from their username.
Get UUIDs by usernames (bulk)Resolve up to 10 Minecraft usernames to their UUIDs in one request.

Get blocked servers

Get Mojang's list of blocked server hashes. Each entry is the SHA-1 hash of a blocked server hostname.

Inputs

None.

Outputs

countnumber
hasheslist
Example output
{
  "count": 2,
  "hashes": [
    "dc2c735b3e6aba51ece294d7de21b947379aac4d",
    "780874bcade721dfccdf2ccd51cec3eb3a35c958"
  ]
}

Get player profile

Get a player's profile by UUID, including the base64-encoded textures property (skin and cape). Optionally include Mojang's signature over the textures data.

Inputs

UUIDuuidtextRequired
The player's Minecraft UUID, for example 853c80ef3c3749fdaa49938b674adae6. Look one up with 'Get UUID by username'.
Include signatureinclude_signaturetrue/false
Also return Mojang's signature over the textures data. Leave off unless you need to verify the data's authenticity.Default: false.

Outputs

profileobject
Example output
{
  "profile": {
    "id": "853c80ef3c3749fdaa49938b674adae6",
    "name": "jeb_",
    "profileActions": [],
    "properties": [
      {
        "name": "textures",
        "value": "eyJ0aW1lc3RhbXAiOjE3ODY2Njk3MDE3MjIsInByb2ZpbGVJZCI6Ijg1M2M4MGVmM2MzNzQ5ZmRhYTQ5OTM4YjY3NGFkYWU2IiwicHJvZmlsZU5hbWUiOiJqZWJfIiwidGV4dHVyZXMiOnsiU0tJTiI6eyJ1cmwiOiJodHRwOi8vdGV4dHVyZXMubWluZWNyYWZ0Lm5ldC90ZXh0dXJlLzdmZDliYTQyYTdjODFlZWVhMjJmMTUyNDI3MWFlODVhOGUwNDVjZTBhZjVhNmFlMTZjNjQwNmFlOTE3ZTY4YjUifSwiQ0FQRSI6eyJ1cmwiOiJodHRwOi8vdGV4dHVyZXMubWluZWNyYWZ0Lm5ldC90ZXh0dXJlLzllNTA3YWZjNTYzNTk5NzhhM2ViM2UzMjM2NzA0MmI4NTNjZGRkMDk5NWQxN2QwZGE5OTU2NjI5MTNmYjAwZjcifX19"
      }
    ]
  }
}

Get player skin & cape

Get a player's skin and cape as ready-to-use image URLs, decoded from their profile: the skin URL and model (classic or slim), and the cape URL if they have one.

Inputs

UUIDuuidtextRequired
The player's Minecraft UUID, for example 853c80ef3c3749fdaa49938b674adae6. Look one up with 'Get UUID by username'.

Outputs

texturesobject
Example output
{
  "textures": {
    "cape_url": "http://textures.minecraft.net/texture/9e507afc56359978a3eb3e32367042b853cddd0995d17d0da995662913fb00f7",
    "name": "jeb_",
    "skin_model": "classic",
    "skin_url": "http://textures.minecraft.net/texture/7fd9ba42a7c81eeea22f1524271ae85a8e045ce0af5a6ae16c6406ae917e68b5",
    "uuid": "853c80ef3c3749fdaa49938b674adae6"
  }
}

Get public keys

Get Mojang's public keys, used to verify signed profile properties, player chat certificates, and authentication data.

Inputs

None.

Outputs

publicKeysobject
Example output
{
  "publicKeys": {
    "authenticationKeys": [
      {
        "publicKey": "MIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAg..."
      }
    ],
    "playerCertificateKeys": [
      {
        "publicKey": "MIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAg..."
      }
    ],
    "profilePropertyKeys": [
      {
        "publicKey": "MIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAg..."
      }
    ]
  }
}

Get username by UUID

Look up a Minecraft player's current username from their UUID (dashed or undashed).

Inputs

UUIDuuidtextRequired
The player's Minecraft UUID, for example 853c80ef3c3749fdaa49938b674adae6. Dashed or undashed are both accepted.

Outputs

playerobject
Example output
{
  "player": {
    "id": "853c80ef3c3749fdaa49938b674adae6",
    "name": "jeb_"
  }
}

Get UUID by username

Look up a Minecraft player's UUID (and canonical name casing) from their username.

Inputs

UsernameusernametextRequired
The player's Minecraft username, for example jeb_. Case-insensitive; the response returns the canonical casing.

Outputs

playerobject
Example output
{
  "player": {
    "id": "853c80ef3c3749fdaa49938b674adae6",
    "name": "jeb_"
  }
}

Get UUIDs by usernames (bulk)

Resolve up to 10 Minecraft usernames to their UUIDs in one request. Usernames that don't exist are omitted from the result.

Inputs

UsernamesusernameslistRequired
The Minecraft usernames to resolve (up to 10 per request).

Outputs

playerslist
Example output
{
  "players": [
    {
      "id": "853c80ef3c3749fdaa49938b674adae6",
      "name": "jeb_"
    },
    {
      "id": "069a79f444e94726a5befca90e38aaf5",
      "name": "Notch"
    },
    {
      "id": "61699b2ed3274a019f1e0ea8c3f06bc6",
      "name": "Dinnerbone"
    }
  ]
}

On this page