Player Lookup Flexible player lookup that auto-detects UUID or username input.
Perform a flexible player lookup by providing either a Minecraft UUID or username. The API automatically detects the input type based on format (UUIDs contain hyphens and are 36 characters long). Returns an enriched response with punishment statistics and profile URLs.
Requires the X-API-Key header with your server's API key.
X-API-Key: your-api-key-here Header Type Required Description X-API-Keystring Yes Your server's API key. Content-Typestring Yes Must be application/json.
Field Type Required Description querystring Yes A Minecraft UUID or username. The API auto-detects the type.
{ "status" : 200 , "message" : "Player found" , "data" : { "minecraftUuid" : "550e8400-e29b-41d4-a716-446655440000" , "currentUsername" : "Notch" , "previousUsernames" : [ "OldName" ], "firstSeen" : "2023-06-01T00:00:00.000Z" , "lastSeen" : "2024-01-15T10:30:00.000Z" , "isOnline" : true , "punishmentStats" : { "totalPunishments" : 5 , "activePunishments" : 1 , "bans" : 1 , "mutes" : 2 , "kicks" : 1 , "warnings" : 1 }, "recentPunishments" : [ { "id" : "pun789" , "type" : "Cheating" , "issuer" : "StaffMember" , "issuedAt" : "2024-01-12T14:00:00.000Z" , "expiresAt" : "2024-02-12T14:00:00.000Z" , "isActive" : true } ], "profileUrl" : "https://myserver.modl.gg/player/550e8400-e29b-41d4-a716-446655440000" , "punishmentsUrl" : "https://myserver.modl.gg/player/550e8400-e29b-41d4-a716-446655440000/punishments" } } Field Type Description data.minecraftUuidstring The player's Minecraft UUID. data.currentUsernamestring The player's most recent username. data.previousUsernamesarray List of previous usernames. data.firstSeenstring ISO 8601 timestamp of the player's first recorded login. data.lastSeenstring ISO 8601 timestamp of the player's most recent recorded login. data.isOnlineboolean Whether the player is currently online. data.punishmentStatsobject Aggregated punishment statistics. data.recentPunishmentsarray The 5 most recent punishments. data.profileUrlstring Direct URL to the player's profile on your panel. data.punishmentsUrlstring Direct URL to the player's punishments page on your panel.
Status Code Description 401Missing or invalid API key. 404Player not found for the given query. 429Rate limit exceeded. 500Internal server error.