---
title: "Get viewer-relevant device settings"
method: GET
path: "/api/v2/viewer/settings"
tags: ["viewer"]
---

# Get viewer-relevant device settings

`GET /api/v2/viewer/settings`

Viewer-relevant settings subset for the C++ viewer.

Narrower than ``DeviceSettingsViewV2`` on purpose: only the keys
the viewer reads at runtime are exposed, so the internal-auth
path doesn't surface operator credential fields. Internal-auth
gated like ``ViewerPlaylistViewV2`` above.

## Response `200`

- ViewerSettingsSerializerV2 — Viewer-relevant subset of device settings. Intentionally narrower than ``DeviceSettingsSerializerV2``: only the keys the viewer actually consults at runtime are exposed, so the C++ viewer's internal-auth path doesn't pull operator fields (``username``, ``auth_backend``, ``player_name``, …) it never needs to read.
  - `shuffle_playlist` boolean, required
  - `show_splash` boolean, required
  - `screen_rotation` 0 | 90 | 180 | 270, required — * `0` - 0 * `90` - 90 * `180` - 180 * `270` - 270
  - `audio_output` string, required
  - `debug_logging` boolean, required

## Other responses

- `403` — No response body

---

[API](https://skmtc.dev/screenly/apis/anthias-api.md) · [All operations](https://skmtc.dev/screenly/apis/anthias-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/screenly/anthias-api/revisions/db7a06ac59cc/schema)