Endpoint description

Get information about the specified player

Endpoint route

GET

/api/v1/players/{Player name}

Response type

Application/Json

Header parameters

KeyValueTypeRequired
AuthorizationBasic [key]stringFor Basic authentication mode only
Authorization[key]stringFor Key-Basic and Key-Advanced authentication modes only

Query Parameters

No parameters

Body parameters

No parameters

Access rights

Authentication typeKey typeAllowed
Openfalse
Basicfalse
Key-Basicfalse
Key-AdvancedPublic keyfalse
Key-AdvancedProtected keyfalse
Key-AdvancedAdmin keyfalse

Success response

// - If the player is online

{
    "entityID": int,                // - For Admin keys only
    "firstPlayed": timestamp,
    "lastPlayed": timestamp,
    "uniqueID": string,             // - For Admin keys only
    "name": string,
    "ping": int,                    // - For Admin keys only
    "allowFlight": bool,            // - For Admin keys only
    "online": bool,
    "exhaustion": float,
    "exp": float,
    "foodLevel": float,
    "health": float,
    "level": int,
    "banned": bool,                 // - For Admin keys only
    "op": bool,                     // - For Admin keys only
    "whitelisted": bool,            // - For Admin keys only
    "World": string,                // - For Admin keys only
    "posX": int,                    // - For Admin keys only
    "posY": int,                    // - For Admin keys only
    "posZ": int                     // - For Admin keys only
}

// - If the player is offline

{
    "firstPlayed": timestamp,   
    "lastPlayed": timestamp,
    "uniqueID": string,             // - For Admin keys only
    "name": string,
    "online": bool,
    "banned": bool,                 // - For Admin keys only
    "op": bool,
    "whitelisted": bool             // - For Admin keys only
}

Error response

{
    "success": bool,
    "code": int,
    "message": string
}

Return codes

HTTP CodeType
200OK
401Unauthorized
403Forbidden
404Not Found