Game

Query MC Former Names

0calls

1 credits / call

Want to know what name a pro player used before? This endpoint helps you trace a Minecraft player's 'dark history'!

Overview

By providing a player's username or UUID, you can get a list of all former names and their change times. This is useful for identifying returning old players or community management.

Usage Notes

Note

Parameter Description

Choose either name or uuid
UUID supports format with hyphens (e.g., ee9b4ed1-aac1-491e-b761-1471be374b80) or without

Important

Response Structure Difference

Query with uuid: Returns single user's history
Query with name: Returns list of all matching users (including players matching current username or former names), check if response has results field to distinguish modes

Query parameters

name

stringoptional

Player's Minecraft username. When using this parameter, returns list of all matching users (including players matching current username or former names).

uuid

stringoptional

Player's Minecraft UUID, supports format with or without hyphens.

Name	Type	Attributes	Description
`name`	string	optional	Player's Minecraft username. When using this parameter, returns list of all matching users (including players matching current username or former names).
`uuid`	string	optional	Player's Minecraft UUID, supports format with or without hyphens.

Response

200 / OK

Query successful! Returns different structures based on query method:

uuid query: Returns single user's history
name query: Returns matching user list (check if response has results field to distinguish)

JSON

400 / Bad Request

Request failed. Please check if you provided at least one of the name or uuid parameters.

JSON

404 / Not Found

User not found. We couldn't find a Minecraft player corresponding to the UUID you provided. Please confirm if the UUID is correct.

JSON

502 / Bad Gateway

Service temporarily unavailable, please try again later.

JSON

Quick start

Pick your language to see usage examples

Auth mode:

cURL command

curl 'https://uapis.cn/api/v1/game/minecraft/historyid'

Frequently asked questions

Are there any special restrictions for the Query MC Former Names API?

Query MC Former Names follows our standard usage policy. Refer to the endpoint reference above for the exact rate limits and parameter requirements. Reach out if you have unusual needs.

Are the APIs on UAPI free to use?

UAPI gives every visitor free credits so you can call any endpoint right away. Visitor credits have a usage cap, and if you need more you can for additional credits.

Do I need to register an account to use UAPI?

No registration is required for visitor credit calls. If you need more credits or want to manage your call history, you can register a free account. Signed-in users get more free credits and can review usage details in the console.

Which languages and use cases does UAPI support?

Our APIs follow standard HTTP and RESTful design, so any language that can send network requests works — including JavaScript (Node.js, Vue, React), Python, Java, PHP, Go, C#, and more. They fit web apps, mobile backends, mini-program cloud functions, automation scripts, and similar scenarios.

PreviousCategory overview

NextQuery MC Server