Retrieves the full device timeline chart payload

Open in ChatGPT Open in ChatGPT to ask questions about this page
Open in Claude Open in Claude to ask questions about this page
Copy as MarkdownCopy this page as markdown to use with AI assistants
View as Markdown Open this page as markdown in a new tab

Returns the full device timeline chart payload for the selected date filter, including configured area, gantt, and bubble groups, threshold metadata, last sync time, and optional no-data or anomaly training messages.

Request URL

https://{serverurl}/intelligence/api/dataStream/{resourceId}/timelineChart

Scope

DesktopCentralCloud.DEX.READCopied!

Header

Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52

Request Parameters

- Request Headers

AcceptstringMandatory
application/streamChartData.v1+jsonapplication/streamChartData.v1+jsonCopied!

- Path Parameters

resourceIdstringMandatory

- Query Parameters

filterIdstringOptional

Date filter identifier. The current implementation expects the timeline filter values, with the default as 0 for last 2 days

Sample Request

Curl
Java
Python
Deluge
PowerShell
Copied!
curl --request GET \
  --url https://appdomains/intelligence/api/dataStream/{resourceId}/timelineChart \
  --header 'Accept: application/streamChartData.v1+json' \
  --header 'Authorization: Zoho-oauthtoken  d92d4xxxxxxxxxxxxx15f52'

Response Parameters

- HTTP code 200

Response Body - application/json
JSON Object
Hide Sub-Attributes
startTimelong

Start of the resolved timeline window in epoch milliseconds

timeSubFunctionstring

Time aggregation function used by the timeline renderer. The current implementation returns ABSMINUTE

intervalstring

Minimum collection interval in minutes used to render the timeline

rawDataJSON Array

Timeline groups rendered in the UI. The exact set depends on the timeline display configuration

Show Sub-Attributes
JSON Object
Show Sub-Attributes
namestring

Localized label of the timeline group such as Device Performance or Device Network

groupIdstring

Timeline group identifier from the timeline display configuration

chartTypestring

Chart type for the group. Common values are area, gantt, or bubble

itemsJSON Array

Metric or series items contained within the timeline group

Show Sub-Attributes
JSON Object
Show Sub-Attributes
namestring

Name of the metric or series item rendered within the timeline group

chartdataJSON Array

Chart series payload consumed directly by the timeline UI

Show Sub-Attributes
JSON Object
Show Sub-Attributes
typestring

Chart series type such as area, gantt, or bubble

dataarray

Nested chart data array. Its inner structure varies by chart type and includes point or row metadata used by the UI

defaultColorarray

Optional default color ordering used for gantt-style timeline items

thresholdJSON Object

Threshold and continuity metadata for the item

Show Sub-Attributes
valuesarray

X-axis points where the threshold or color state changes for the item

colorsarray

Color markers such as RAW_DATA_ENDED, ANOMALY_ENDED, or NO_DATA_ENDED used by the renderer

noDataRegionsarray

Flat array of start and end epoch values describing gaps in the timeline data

rangeJSON Object

Minimum and maximum visible x-axis bounds for the item

Show Sub-Attributes
minRangelong

Minimum x-axis bound in epoch milliseconds

maxRangelong

Maximum x-axis bound in epoch milliseconds

rulerJSON Object

Unified ruler and threshold overlay derived from all timeline groups

Show Sub-Attributes
chartdataJSON Array

Chart overlay series for the unified ruler

Show Sub-Attributes
JSON Object
Show Sub-Attributes
typestring

Chart series type such as area, gantt, or bubble

dataarray

Nested chart data array. Its inner structure varies by chart type and includes point or row metadata used by the UI

thresholdJSON Object

Unified threshold metadata for the overall timeline view

Show Sub-Attributes
valuesarray

X-axis points where the threshold or color state changes for the item

colorsarray

Color markers such as RAW_DATA_ENDED, ANOMALY_ENDED, or NO_DATA_ENDED used by the renderer

noDataRegionsarray

Flat array of start and end epoch values describing gaps in the timeline data

rangeJSON Object

Minimum and maximum visible x-axis bounds for the item

Show Sub-Attributes
minRangelong

Minimum x-axis bound in epoch milliseconds

maxRangelong

Maximum x-axis bound in epoch milliseconds

lastSyncTimestring

Formatted timestamp of the latest timeline data synced for the device, or -- when unavailable

anomalyDetectionstring

Optional anomaly model training message shown while anomaly detection is still being trained for the device

noDataTitlestring

Optional no-data title shown when there is no usable timeline data for the selected range

noDataDescriptionstring

Optional no-data description shown when there is no usable timeline data for the selected range

learnMorestring

Product help URL for the device timeline page

Possible Response Codes

200HTTP code

Sample Response: HTTP 200

Copied!
  {
    "lastSyncTime": "Apr 01, 2026 10:10 AM",
    "learnMore": "https://www.manageengine.com/products/desktop-central/help/endpoint-analytics/device-timeline.html",
    "startTime": 1774992000000,
    "interval": 10,
    "noDataDescription": null,
    "rawData": [
      {
        "groupId": 2,
        "name": "Device Performance",
        "chartType": "area",
        "items": [
          {
            "defaultColor": [],
            "name": "CPU",
            "threshold": {
              "noDataRegions": [],
              "values": [
                1775018400000
              ],
              "range": {
                "maxRange": 1775078399999,
                "minRange": 1774992000000
              },
              "colors": [
                "RAW_DATA_ENDED"
              ]
            },
            "chartdata": [
              {
                "data": [
                  [
                    [
                      1775018400000,
                      27.5,
                      [
                        {
                          "duration": "10 mins",
                          "metricId": 1,
                          "groupId": 2,
                          "groupLabel": "CPU",
                          "startTime": 1775017800000,
                          "endTime": 1775018400000,
                          "metrics": [
                            {
                              "label": "Average CPU usage",
                              "value": "27.5 %"
                            },
                            {
                              "label": "CPU interrupt",
                              "value": "0.17 %"
                            }
                          ]
                        }
                      ]
                    ]
                  ]
                ],
                "type": "area"
              }
            ]
          }
        ]
      },
      {
        "groupId": 3,
        "name": "Device Network",
        "chartType": "gantt",
        "items": [
          {
            "defaultColor": [
              "USER_ACTIVE_STATUS"
            ],
            "name": "WiFi",
            "threshold": {
              "noDataRegions": [],
              "values": [],
              "range": {
                "maxRange": 1775078399999,
                "minRange": 1774992000000
              },
              "colors": []
            },
            "chartdata": [
              {
                "data": [
                  [
                    [
                      1775018400000,
                      1775019000000
                    ],
                    "WiFi",
                    [
                      {
                        "duration": "10 mins",
                        "metricId": 1,
                        "groupId": 3,
                        "groupLabel": "WiFi",
                        "startTime": "1775018400000",
                        "endTime": "1775019000000",
                        "metrics": [
                          {
                            "label": "Signal Strength",
                            "value": "92 %"
                          }
                        ]
                      }
                    ]
                  ]
                ],
                "type": "gantt"
              }
            ]
          }
        ]
      }
    ],
    "ruler": {
      "threshold": {
        "noDataRegions": [],
        "values": [],
        "range": {
          "maxRange": 1775078399999,
          "minRange": 1774992000000
        },
        "colors": []
      },
      "chartdata": [
        {
          "data": [
            []
          ],
          "type": "area"
        }
      ]
    },
    "noDataTitle": null,
    "timeSubFunction": "ABSMINUTE",
    "anomalyDetection": null
  }
                
Show full

Duration: 1 minute | Threshold: 30 | Lock period: 5 minutes

Duration - Time window for the threshold.
Threshold - Number of API calls allowed within the specified duration.
Lock Period - Wait time before consecutive API requests.