Server Identity

This API command is used to get the capabilities of the Plex Media server. The capabilities returned include such items as the settings of the Plex server, the operating system, and the version of Plex that is installed.

URL

GET http://{ip_address}:32400/identity/?X-Plex-Token={plex_token}

Parameters

NameDescription
ip_addressThe IP address of the Plex Media server.
plex_tokenThe Plex token.

Return Status

HTTP CodeDescription
200Success - The request was successful.

Response

XML string value that shows basic information of the server. An example of the XML returned from the request is shown below:

<?xml version="1.0" encoding="UTF-8"?>
<MediaContainer size="0" claimed="1" machineIdentifier="6a646027a56abb6dbdf72484564db8567c737430" version="1.29.1.6316-f4cdfea9c">
</MediaContainer>

Remarks

The XML returned contains basic information of the server in the attributes of the MediaContainer element. Each attribute corresponds to some data point, and the status of that data. There isn't actual documentation on each attribute, so the list below is a best-guess at what the values represent.

Unlike other Plex API requests, the identity request does not require a Plex token and can be run from any machine that can access the Plex server from a Web browser.

Since this request returns a small XML string, this request can be used to quickly determine if a server has been claimed, or the Plex version installed.

The attribute values correspond to the the following:

Plex Media Server Capabilities
AttributeDescription
sizeNumber of child items in the MediaContainer item.
claimed1 - server is claimed.
0 - server is not claimed.
machineIdentifierUnique identifier for the server.
versionCurrent installed version of Plex for the server.

Examples

curl -X GET http://{ip_address}:32400/identity/?X-Plex-Token={plex_token}
import requests
plex_url = http://{ip_address}:32400/identity/?X-Plex-Token={plex_token}
response = requests.get(plex_url)
print(response.text)
$response = Invoke-RestMethod 'http://{ip_address}:32400/identity/?X-Plex-Token={plex_token}' -Method 'GET'
Write-Output $response
Subscribe
Display