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

Return Status

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:

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