---
title: "Get a screen's playback and device quality"
method: GET
path: "/v1/screens/{id}/quality"
tags: ["screens"]
---

# Get a screen's playback and device quality

`GET /v1/screens/{id}/quality`

## Request

- Base URL: `https://api.brixsignage.com`
- URL: `https://api.brixsignage.com/v1/screens/{id}/quality`
- Auth: HTTP bearer

Returns the quality data the screen's Health tab shows: the content items that played badly in the last 7 days (worst first), how often the player started today and why, and the device health readings from the last 24 hours, such as frame gaps, decoder failures, cache clears and the highest temperature.

## Path parameters

- `id` string, required

## Response `200`

Success.

- object
  - `data` object, required
    - `problemItems` object[], required: Items that failed or played badly on this screen in the last 7 days, worst first.
      - `contentId` string, required
      - `name` string, nullable, required
      - `kind` string, nullable, required
      - `plays` integer, required
      - `fails` integer, required
      - `lastFailReason` string, nullable, required
      - `ttffMsMax` number, nullable, required
      - `stallCount` integer, required
      - `stallMsMax` number, nullable, required
      - `blackMsMax` number, nullable, required
      - `dropPctMax` number, nullable, required
      - `seamWorstMs` number, nullable, required
      - `path` string, nullable, required
      - `src` string, nullable, required
      - `days` integer, required
    - `restartsToday` object, required: Player starts since 00:00 UTC, per launch reason.
    - `restartSummary` string, nullable, required
    - `mediaBench` object, nullable, required: The screen's own media self-test (what it can decode), when it has run.
      - `version` string, required
      - `measuredAt` string, required: ISO-8601 timestamp (UTC).
      - `codecs` object, required
      - `clip` object, nullable, required
        - `ttffMs` number, nullable, required
        - `dropPct` number, nullable, required
    - `signals` object, nullable, required: The last 24 hours of device-health readings. Null when the screen reported none.
      - `frameGaps` number, nullable, required
      - `frameGapMaxMs` number, nullable, required
      - `anrs` number, nullable, required
      - `decoderFailures` number, nullable, required
      - `cacheWipes` number, nullable, required
      - `maxTempC` number, nullable, required
      - `memoryDegradeStep` number, nullable, required
      - `liveVideoEls` number, nullable, required
      - `liveIframes` number, nullable, required

## Other responses

- `401`: Missing, expired or revoked bearer token.
- `403`: The token lacks the permission this operation needs (see `x-brix-permission`).
- `5XX`: Server error. The body carries a `requestId` to quote to support.

---

[API](https://skmtc.dev/brixsignage/apis/brix-api.md) · [All operations](https://skmtc.dev/brixsignage/apis/brix-api/llms.txt) · [OpenAPI document](https://skmtc.dev/brixsignage/apis/brix-api/revisions/02fd3665dc7d?raw)