πPlayer
The following endpoint will return global player information and statistics:
Getting global information about a player
GET https://api.comugamers.net/player
Gets all public information about a specific player.
Query Parameters
username*
String
The username of the player.
uuid
String
The player's unique ID. Due to how our authentication system works, player UUIDs may differ from what you would normally see.
{
"status": 400,
"message": "Bad Request"
}{
"status": 404,
"message": "Not Found"
}{
"status": 200,
"data": {
"uuid": "2477aadd-23bf-47dd-a556-38bde5ce9371",
"username": "Jojo1545",
"privacyPreferences": {
"statisticsShown": true,
"medalsShown": true,
"linkedAccountsShown": false,
"basicInformationShown": true
},
"info": {
"firstSeen": 1687659380,
"lastSeen": 1704647226,
"language": "es-ES",
"tag": null,
"playerRank": {
"id": 1,
"content": "OWNER",
"ultraColor": {
"id": 0,
"code": "f"
}
}
},
"globalStats": {
"gems": 279,
"xp": 129,
"elo": 0,
"lastKnownLevel": 1,
"medals": [{
"type": "THE_BEGINNING",
"timestamp": 1674257846
}, {
"type": "BUG_HUNTER",
"timestamp": 1676241297
}, {
"type": "DEVELOPMENT_TEAM",
"timestamp": 1676241634
}, {
"type": "STAFF_MEMBER",
"timestamp": 1676241640
}, {
"type": "SUPPORT_TEAM",
"timestamp": 1676241644
}, {
"type": "EIGHT_YEARS",
"timestamp": 1676241651
}, {
"type": "SEVEN_YEARS",
"timestamp": 1676241654
}, {
"type": "SIX_YEARS",
"timestamp": 1676241659
}, {
"type": "FIVE_YEARS",
"timestamp": 1676241663
}, {
"type": "FOUR_YEARS",
"timestamp": 1676241667
}, {
"type": "THREE_YEARS",
"timestamp": 1676241671
}, {
"type": "TWO_YEARS",
"timestamp": 1676241675
}, {
"type": "CREATIVE_MIND",
"timestamp": 1676241694
}, {
"type": "NINE_YEARS",
"timestamp": 1676241699
}, {
"type": "DONATOR",
"timestamp": 1676241705
}, {
"type": "TEN_YEARS",
"timestamp": 1681487218
}, {
"type": "BUILDER",
"timestamp": 1686448012
}, {
"type": "HALLOWEEN_2023",
"timestamp": 1697155993
}]
}
}
}Player information
uuid
UUID
The unique ID of the player.
username
String
The name of the player.
privacyPreferences
Object
The privacy preferences of a player, as they're able to disable certain parts of their data from being shown on the Public API.
info
Object
Contains basic player information, such as their first login, last login and language.
globalStats
Object
Contains global player statistics.
linkedAccounts
Object
Contains the linked accounts of a player. Hidden by default, but can be enabled from the /settings menu in-game.
statisticsShown
boolean
Whether statistics should be shown.
medalsShown
boolean
Whether medals should be shown.
linkedAccountsShown
boolean
Whether linked accounts should be shown.
basicInformationShown
boolean
Whether basic information such as the first login, last login and preferred language should be shown.
firstSeen
Long
The date when this player was first seen.
This might *not* reflect the real date a player was first seen, as these were reset somewhere around late Q2 2023.
lastSeen
Long
The date and time on which the player was last seen.
language
String
The preferred player language. Can be en-US, es-ES, fr-FR or ru-RU.
playerRank
Object
The rank assigned to this player.
tag
Object
Optional: The tag shown next to the player's name. Can be considered a suffix.
gems
Integer
The amount of gems the player currently has.
xp
Integer
The current total XP count of the player.
lastKnownLevel
Integer
The last known level of the player.
elo
Integer
The amount of ELO the player currently has.
medals
Object[]
Array of Medal objects obtained by the player.
discord
String
The linked Discord account.
String
The linked Twitter (also known as X) account.
youtube
String
The linked YouTube account.
twitch
String
The linked Twitch account.
id
Integer
The rank ID.
content
String
A human-readable string representation of the rank.
ultraColor
Object
Preferred ULTRA rank color of the player.
id
Byte
The ID of the selected ULTRA color.
code
String
The Minecraft color code.
id
Integer
The ID of the selected player tag.
content
String
The content of the selected player tag.
color
String
The player's preferred tag color.
type
String
The medal name.
timestamp
Long
The time that the player get the medal.
Fetching player information
Last updated