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

---
title: Player Username to UUID
summary: 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

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

## Response

```json
{
  "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. |