listScreenPlayerHistory

GET

/api/v1/screens/{id}/player-history

curl --request GET \
  --url https://example.com/api/v1/screens/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/player-history

List screen player history. Requires an authenticated dashboard user.

Parameters

Path Parameters

id

required

string format: uuid

Responses

200

Current and retired physical player records

Media typeapplication/json

object

data

required

object

items

required

Array<object>

object

id

required

string format: uuid

screenId

required

string format: uuid

credentialId

string format: uuid

installationId

required

string

platform

required

string

manufacturer

required

string

model

required

string

androidVersion

required

string

playerVersion

required

string

screenWidth

required

integer

screenHeight

required

integer

density

required

number

locale

required

string

timezone

required

string

pairedAt

required

string format: date-time

retiredAt

string format: date-time

retirementReason

string

total

required

integer

Example^generated

{
  "data": {
    "items": [
      {
        "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
        "screenId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
        "credentialId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
        "installationId": "example",
        "platform": "example",
        "manufacturer": "example",
        "model": "example",
        "androidVersion": "example",
        "playerVersion": "example",
        "screenWidth": 1,
        "screenHeight": 1,
        "density": 1,
        "locale": "example",
        "timezone": "example",
        "pairedAt": "2026-04-15T12:00:00Z",
        "retiredAt": "2026-04-15T12:00:00Z",
        "retirementReason": "example"
      }
    ],
    "total": 1
  }
}

404

Screen not found