GET /player/{player_identifier}

Endpoint: GET /v1/pdapi/player/<player_identifier>

Auth: Bearer token

Permission: REST.Player.Read

Purpose

Returns one player. The identifier can be a supported player identifier such as UserId or PlayerUID.

None.

No request body.

Field	Type	Description
`Player`	object	Player details.

Player object schema:

Field	Type	Description
`Name`	string	Current or saved player name.
`IP`	string	Player IP address, or an empty string when unavailable.
`PlayerUID`	string	Player UID used by Palworld save data.
`UserId`	string	Platform user ID, or an empty string when unavailable.
`GuildName`	string	Guild name, or an empty string when unavailable.
`GuildUUID`	string	Guild UUID, or a zero GUID when unavailable.
`Status`	string	Saved player account state.
`WorldLocation`	object	Current or last saved world coordinates.
`MapLocation`	object	Converted map coordinates.

Location object schema:

Error bodies use this shape:

{
    "Error": {
        "Code": "ERROR_CODE",
        "Message": "Human-readable message",
        "Details": {}
    }
}

HTTP	Error code	When it happens
`401`	`INVALID_TOKEN`	The `Authorization` header is missing, malformed, or does not match a configured bearer token.
`403`	`MISSING_PERMISSION`	The token is valid, but it does not include this endpoint permission.
`400`	`INVALID_JSON`	A request body was supplied, but it could not be parsed as JSON.
`400`	`REQUEST_FAILED`	The game-thread callback threw an exception, or a shared player/resource resolver failed.
`500`	`REQUEST_TIMEOUT`	The internal game-thread callback did not complete within 5 seconds.
`404`	`PLAYER_NOT_FOUND`	No online player matched the supplied `player_identifier`.
`404`	`PLAYER_ACCOUNT_NOT_FOUND`	The player was found, but the player account data could not be loaded.

GET /v1/pdapi/player/steam_76561198012345678

GET /v1/pdapi/player/b7f4e91a-2c53-4d8f-a6e1-93c4bb62a7d1