# Plex Devices API

**Canonical:** https://apis.io/apis/plex/plex-devices-api/  
**Provider:** Plex — https://apis.io/providers/plex/  
**Base URL:** https://1-2-3-4.0123456789abcdef0123456789abcdef.plex.direct:32400  
**Documentation:** https://developer.plex.tv/pms/

Plex Devices API is one of 31 APIs that [Plex](https://apis.io/providers/plex/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Devices. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

Media grabbers provide ways for media to be obtained for a given protocol. The simplest ones are `stream` and `download`. More complex grabbers can have associated devices Network tuners can present themselves on the network using the Simple Service Discovery Protocol and Plex Media Server will discover them. The following XML is an example of the data returned from SSDP. The `deviceType`, `serviceType`, and `serviceId` values must remain as they are in the example in order for PMS to properly discover the device. Other less-obvious fields are described in the parameters section below. Example SSDP output ``` <root xmlns="urn:schemas-upnp-org:device-1-0"> <specVersion> <major>1</major> <minor>0</minor> </specVersion> <device> <deviceType>urn:plex-tv:device:Media:1</deviceType> <friendlyName>Turing Hopper 3000</friendlyName> <manufacturer>Plex, Inc.</manufacturer> <manufacturerURL>https://plex.tv/</manufacturerURL> <modelDescription>Turing Hopper 3000 Media Grabber</modelDescription> <modelName>Plex Media Grabber</modelName> <modelNumber>1</modelNumber> <modelURL>https://plex.tv</modelURL> <UDN>uuid:42fde8e4-93b6-41e5-8a63-12d848655811</UDN> <serviceList> <service> <URLBase>http://10.0.0.5:8088</URLBase> <serviceType>urn:plex-tv:service:MediaGrabber:1</serviceType> <serviceId>urn:plex-tv:serviceId:MediaGrabber</serviceId> </service> </serviceList> </device> </root> ``` - UDN: (string) A UUID for the device. This should be unique across models of a device at minimum. - URLBase: (string) The base HTTP URL for the device from which all of the other endpoints are hosted.

## Machine-readable artifacts (3)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/plex/refs/heads/main/openapi/plex-devices-api-openapi.yml
- **Documentation** — https://developer.plex.tv/pms/
- **APIReference** — https://developer.plex.tv/pms/

## Other Plex APIs (12)

- [Plex Account and Authentication API](https://apis.io/apis/plex/plex-account-api/)
- [Plex MCP Server](https://apis.io/apis/plex/plex-mcp-server/)
- [Plex Activities API](https://apis.io/apis/plex/plex-activities-api/)
- [Plex Butler API](https://apis.io/apis/plex/plex-butler-api/)
- [Plex Collections API](https://apis.io/apis/plex/plex-collections-api/)
- [Plex Content API](https://apis.io/apis/plex/plex-content-api/)
- [Plex Download Queue API](https://apis.io/apis/plex/plex-download-queue-api/)
- [Plex DV Rs API](https://apis.io/apis/plex/plex-dvrs-api/)
- [Plex EPG API](https://apis.io/apis/plex/plex-epg-api/)
- [Plex Events API](https://apis.io/apis/plex/plex-events-api/)
- [Plex General API](https://apis.io/apis/plex/plex-general-api/)
- [Plex Hubs API](https://apis.io/apis/plex/plex-hubs-api/)

## Tags

Devices

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/plex/plex-devices-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/plex/.