OrgsClientsMarvis

getOrgMarvisClientInsights

GET
/api/v1/orgs/{org_id}/insights/marvisclient/{marvisclient_id}/marvisclient-metrics

Return time-series metrics for a specific Marvis Client device. For the full list of supported metric field names and example values, refer to List Insight Metrics under /api/v1/const/insight_metrics.

Authorization

Authorization<token>

Preferred authentication method for automation and integrations. Send the API token in the HTTP Authorization header.

Format: Authorization: Token {apitoken}

Notes:

  • An API token generated for a specific admin has the same privileges as that admin
  • An API token is automatically removed if it is not used for more than 90 days
  • SSO admins cannot generate admin API tokens. Use organization API tokens when scoped Org/Site privileges are needed.

In: header

Path Parameters

org_id*string
Formatuuid
marvisclient_id*string

Marvis Client device UUID

Formatuuid

Query Parameters

duration?string

Time range duration for the query, using relative units such as 10m, 7d, or 2w

Default"1d"
interval?string

Aggregation works by giving a time range plus interval (e.g. 1d, 1h, 10m) where aggregation function would be applied to.

start?string

Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as -1d or -1w

end?string

Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as -1d, -2h, or now

limit?integer

Maximum number of results to return per page

Range0 <= value
Default100
page?integer

Select the page number to return when using page-based pagination; starts at 1

Range1 <= value
Default1

Response Body

curl -X GET "https://example.com/api/v1/orgs/000000ab-00ab-00ab-00ab-0000000000ab/insights/marvisclient/497f6eca-6276-4993-bfeb-53cbbbba6f08/marvisclient-metrics"
{  "avg_battery": [    82,    79  ],  "avg_cellular_rssi": [    -95,    -92  ],  "avg_cpu": [    12.5,    15.2  ],  "avg_memory": [    43.1,    44.8  ],  "avg_wifi_rssi": [    -62,    -60  ],  "end": 1717113600,  "interval": 3600,  "limit": 100,  "page": 1,  "rt": [    "2026-05-30T16:00:00Z",    "2026-05-30T17:00:00Z"  ],  "start": 1717027200}