Skip to content
Tilecast Docs

getIncidentAnalytics

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

Read incident analytics. Requires an authenticated dashboard user with the read scope.

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”

Incident analytics

Media typeapplication/json
object
data
required
object
range
required
object
from
required
string format: date-time
to
required
string format: date-time
activeIncidents
required
integer format: int64
incidentsOpened
required
integer format: int64
incidentsResolved
required
integer format: int64
meanTimeToRecoverSeconds
required
number | null
medianTimeToRecoverSeconds
required
number | null
longestIncidentSeconds
required
number | null
longestIncidentTitle
string
automaticRecoveries
required
integer format: int64
manualRecoveries
required
integer format: int64
recurring
required
Array<object>
object
screenId
string
screenName
required
string
incidentType
required
string
incidents
required
integer format: int64
occurrences
required
integer format: int64
byScreen
required
Array<object>
object
key
required
string
label
required
string
count
required
integer format: int64
byLocation
required
Array<object>
object
key
required
string
label
required
string
count
required
integer format: int64
byDeviceModel
required
Array<object>
object
key
required
string
label
required
string
count
required
integer format: int64
byPlayerVersion
required
Array<object>
object
key
required
string
label
required
string
count
required
integer format: int64
byFailureCode
required
Array<object>
object
key
required
string
label
required
string
count
required
integer format: int64
byType
required
Array<object>
object
key
required
string
label
required
string
count
required
integer format: int64
Examplegenerated
{
  "data": {
    "range": {
      "from": "2026-04-15T12:00:00Z",
      "to": "2026-04-15T12:00:00Z"
    },
    "activeIncidents": 1,
    "incidentsOpened": 1,
    "incidentsResolved": 1,
    "meanTimeToRecoverSeconds": 1,
    "medianTimeToRecoverSeconds": 1,
    "longestIncidentSeconds": 1,
    "longestIncidentTitle": "example",
    "automaticRecoveries": 1,
    "manualRecoveries": 1,
    "recurring": [
      {
        "screenId": "example",
        "screenName": "example",
        "incidentType": "example",
        "incidents": 1,
        "occurrences": 1
      }
    ],
    "byScreen": [
      {
        "key": "example",
        "label": "example",
        "count": 1
      }
    ],
    "byLocation": [
      {
        "key": "example",
        "label": "example",
        "count": 1
      }
    ],
    "byDeviceModel": [
      {
        "key": "example",
        "label": "example",
        "count": 1
      }
    ],
    "byPlayerVersion": [
      {
        "key": "example",
        "label": "example",
        "count": 1
      }
    ],
    "byFailureCode": [
      {
        "key": "example",
        "label": "example",
        "count": 1
      }
    ],
    "byType": [
      {
        "key": "example",
        "label": "example",
        "count": 1
      }
    ]
  }
}

401

Section titled “401”

Dashboard authentication required

422

Section titled “422”

Range invalid