---
title: "List the playlist for one device"
method: GET
path: "/api/devices/{device_id}/playlist_items"
tags: ["Playlists"]
---

# List the playlist for one device

`GET /api/devices/{device_id}/playlist_items`

## Request

- Base URL: `https://trmnl.com`
- URL: `https://trmnl.com/api/devices/{device_id}/playlist_items`
- Auth: HTTP bearer

## Path parameters

- `device_id` integer, required

## Response `200`

Reads as empty for a device belonging to someone else

- object
  - `data` PlaylistItem[]
    - `presentation` object
    - `created_at` string, date_time
    - `configuration_state` 'configured' | 'needs_configuration'
    - `device_id` integer
    - `id` integer
    - `mashup_id` integer, nullable
    - `mirror` boolean
    - `plugin` object, nullable
      - `id` integer
      - `name` string
      - `keyname` string
      - `description` string, nullable
      - `image` string, nullable
      - `image_dark` string, nullable
    - `plugin_id` integer, nullable
    - `plugin_setting` PluginSetting
      - `sync` PluginSync
        - `source_kinds` string[], required
        - `upload_allowed` boolean, required
        - `reason` string, nullable
        - `action_id` string, nullable
      - `id` integer
      - `name` string
      - `description` string, nullable
      - `plugin_id` integer
      - `refresh_interval` integer, nullable: Minutes between renders
      - `health_notification_enabled` boolean
      - `icon_url` string, nullable
      - `icon_content_type` string, nullable
      - `read_only?` boolean
      - `strategy` string, nullable
    - `plugin_setting_id` integer, nullable
    - `rendered_at` string, date_time, nullable
    - `row_order` integer
    - `updated_at` string, date_time
    - `visible` boolean
    - `palette_id` string, nullable: Overrides the device palette for this item
    - `font_family` string, nullable
    - `text_scale` string, nullable
    - `theme` string, nullable

## Other responses

- `401`: Unauthorized

---

[API](https://skmtc.dev/trmnl/apis/trmnl-api.md) · [All operations](https://skmtc.dev/trmnl/apis/trmnl-api/llms.txt) · [OpenAPI document](https://skmtc.dev/trmnl/apis/trmnl-api/revisions/66179e6d663b?raw)