Frontend/documentation/player/username-to-uuid.md

title	summary
Player Username to UUID	Get a player's UUID from their username.

Overview

The player username to UUID endpoint allows you to get a player's UUID from their username.

Endpoint

GET /player/uuid/:query

Parameters

Parameter	Description	Required
query	The username of the player you want to look up.	Yes

Example

curl -X GET "https://api.mcutils.xyz/player/uuid/imfascinated" -H "accept: application/json"

Response

{
  "cache": {
    "cached": false,
    "cachedTime": -1
  },
  "uniqueId": "eeab5f8a-18dd-4d58-af78-2b3c4543da48",
  "username": "ImFascinated"
}

Errors

Status Code	Description
400	The username is invalid.
429	The Mojang API rate limit has been exhausted.