Skip to content
Tilecast Docs

getActivityOverview

GET
/api/v1/activity/overview
curl --request GET \
  --url https://example.com/api/v1/activity/overview \
  --cookie tilecast_session=<tilecast_session>

Requires an authenticated user with the read scope. Fleet activity overview for a time window: summary cards, fleet health, and the warning-and-error timeline. from and to are RFC 3339 timestamps defaulting to the last 24 hours; an unparsable range fails with 422 activity_range_invalid.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “ Parameters ”

Query Parameters

Section titled “Query Parameters”
from
string format: date-time
to
string format: date-time

Responses

Section titled “ Responses ”

200

Section titled “200”

Activity overview

Media typeapplication/json
object
data
required
object
range
required
object
from
required
string format: date-time
to
required
string format: date-time
cards
required
object
screensWithReportingGaps
required
integer format: int64
confirmedScreenPlaybackMs
required
integer format: int64
contentExposureMs
required
integer format: int64
playbackFailures
required
integer format: int64
interruptedPlays
required
integer format: int64
takeoverActivations
required
integer format: int64
failedPlayerUpdates
required
integer format: int64
recentAdministrativeChanges
required
integer format: int64
fleet
object
measured
required
integer format: int64
online
required
integer format: int64
healthy
required
integer format: int64
impaired
required
integer format: int64
offline
required
integer format: int64
unmeasured
required
integer format: int64
timeline
required
Array<object>
object
id
required
string
timestamp
required
string format: date-time
domain
required
string
severity
required
string
description
required
string
screenId
string format: uuid
resourceId
string
Examplegenerated
{
  "data": {
    "range": {
      "from": "2026-04-15T12:00:00Z",
      "to": "2026-04-15T12:00:00Z"
    },
    "cards": {
      "screensWithReportingGaps": 1,
      "confirmedScreenPlaybackMs": 1,
      "contentExposureMs": 1,
      "playbackFailures": 1,
      "interruptedPlays": 1,
      "takeoverActivations": 1,
      "failedPlayerUpdates": 1,
      "recentAdministrativeChanges": 1
    },
    "fleet": {
      "measured": 1,
      "online": 1,
      "healthy": 1,
      "impaired": 1,
      "offline": 1,
      "unmeasured": 1
    },
    "timeline": [
      {
        "id": "example",
        "timestamp": "2026-04-15T12:00:00Z",
        "domain": "example",
        "severity": "example",
        "description": "example",
        "screenId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
        "resourceId": "example"
      }
    ]
  }
}

401

Section titled “401”

Dashboard authentication required

422

Section titled “422”

Activity_range_invalid