---
title: "Get a screen's display history"
method: GET
path: "/v1/screens/{id}/display-history"
tags: ["screens"]
---

# Get a screen's display history

`GET /v1/screens/{id}/display-history`

## Request

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

Get the history of what the physical display itself did, such as being switched off, switched to another HDMI input, losing its HDMI connection, or coming back, separate from whether the player software was online. Entries are newest first, each showing how long the previous state lasted, along with the current state. This data is only available for displays that support CEC, and history is limited to the last 14 days.

## Path parameters

- `id` string, required

## Query parameters

- `days` string
- `limit` string

## Response `200`

Success.

- object
  - `data` object, required
    - `screenId` string, required
    - `windowDays` integer, required
    - `retentionDays` integer, required
    - `current` object, nullable, required: What the panel is doing now; null when the device cannot read the panel.
      - `state` 'standby' | 'wrong-input' | 'disconnected' | 'input-unconfirmed' | 'lit', required
      - `since` string, nullable, required: ISO-8601 timestamp (UTC).
    - `changes` object[], required
      - `id` string, required
      - `at` string, required: ISO-8601 timestamp (UTC).
      - `from` 'standby' | 'wrong-input' | 'disconnected' | 'input-unconfirmed' | 'lit', required
      - `to` 'standby' | 'wrong-input' | 'disconnected' | 'input-unconfirmed' | 'lit', required
      - `forSec` number, nullable, required
      - `basis` 'probe' | 'seen-switch' | 'stored-guess', required: What the TV input reading stood on: a probe the player ran, an input change it saw, or its last stored value.
      - `basisLabel` string, required: `basis` in plain words.
    - `truncated` boolean, required
    - `dailySummaries` string[], required: The device's daily TV input summaries in the window, newest first, one line each.

## 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)