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'!

GET
uapis.cn
/api/v1/game/minecraft/historyid
Query parameters
2
uuid
string

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

name
string
Pro

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

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.

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
{
  // 【Returns when name query】Queried username.
  "query": "ExamplePlayer",
  // 【Returns when name query】Number of matched users, 0 means not found.
  "count": 2,
  // 【Returns when name query】List of matched users, includes all players matching current username or former names.
  "results": [
    {
      // Player's current username.
      "id": "ExamplePlayer",
      // Player's UUID (with hyphens format).
      "uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      // Total number of historical names.
      "name_num": 1,
      // Array of historical usernames.
      "history": [
        {
          "name": "ExamplePlayer",
          "changedToAt": "2023/09/13 10:10:06"
        }
      ]
    }
  ],
  // [Returned when querying by uuid] Player's current username.
  "id": "T8K_",
  // [Returned when querying by uuid] Queried player's UUID (with hyphens format).
  "uuid": "ee9b4ed1-aac1-491e-b761-1471be374b80",
  // [Returned when querying by uuid] Total number of historical names (including current name).
  "name_num": 4,
  // [Returned when querying by uuid] Array containing all historical usernames, sorted in reverse chronological order.
  "history": [
    {
      // Time when renamed to this name, format is `YYYY/MM/DD HH:mm:ss`. If it's the initial name, it will be `Initial`.
      "changedToAt": "2015/02/04 22:42:25",
      // Username used at that time.
      "name": "jeb_"
    }
  ]
}

400 / Bad Request

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

JSON
{
  "code": "INVALID_ARGUMENT",
  "details": {},
  "message": "uuid or name query parameter is required"
}

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
{
  "code": "NOT_FOUND",
  "details": {},
  "message": "User with the specified UUID not found."
}

502 / Bad Gateway

Service temporarily unavailable, please try again later.

JSON
{
  "code": "UPSTREAM_ERROR",
  "details": {},
  "message": "Service temporarily unavailable."
}