Plex.tv API Documentation

Plex.tv is the web site hosted by Plex that performs many functions for your Plex Media Server. Some functions include logging into your Plex server, managing Plex accounts and claiming your Plex server.

The API found within this section will list what requests that can be sent to the Plex.tv endpoint and what data is returned in each request.

Documentation organization

This API is organized into various categories to help sort the API requests that can be sent to a Plex server. I have tried to provide as much documentation about each request as I could, however, there is sometimes limited information about the return data from an API request.

In addition, I will continue to add more API commands to this site as I am able to find and report the commands.

The current API commands that are available on this site can be found in the list on the left side. The commands are organized into various sections to make finding the correct API command easier.

The Plex token

Most Plex.tv API commands will require a Plex token to be passed in as a parameter. Most commands will require the Plex administrative token.

Providing an invalid token, or a token that doesn't have correct access to make the request, will result in HTTP error 401 - Unauthorized.

JSON response

By default, Plex will return XML data for those API requests that return a response with data. This is what is described on the pages of the API commands.

Plex also can return a response in JSON format if you wish to work with JSON.

To have Plex return JSON, you simply add the following header to the API request:

Accept: application/json