OrgsStatsMarvis Clients

searchOrgMarvisClientsStats

GET
/api/v1/orgs/{org_id}/stats/marvisclients/search

Search Marvis Client stats records across the organization.

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

Query Parameters

device_id?string

Filter by Marvis Client installation device UUID

wifi_mac?string

Filter by device Wi-Fi MAC address

wifi_ip?string

Filter by device Wi-Fi IP address

hostname?string

Filter by device hostname

model?string

Filter by device model

mfg?string

Filter by device manufacturer

serial?string

Filter by device serial number

os_type?string

Filter by device OS type or platform

os_version?string

Filter by device OS version

limit?integer

Maximum number of results to return per page

Range0 <= value
Default100
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

duration?string

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

Default"1d"

Response Body

curl -X GET "https://example.com/api/v1/orgs/000000ab-00ab-00ab-00ab-0000000000ab/stats/marvisclients/search"
{  "limit": 100,  "results": [    {      "battery_charging": false,      "battery_level": 82,      "cpu_background": 2.1,      "cpu_idle": 78.3,      "cpu_system": 5.4,      "cpu_user": 14.2,      "device_id": "0c2a2c6c-5a95-4956-a02d-e1b39c2e5c6e",      "hostname": "my-android-phone",      "location": {        "map_id": "b4695157-0d1d-4da0-8f9e-5c38149d8b81",        "site_id": "d14f16d8-d14f-11e5-8e81-1258369c38a9",        "timestamp": 1717027100,        "x": 423.5,        "y": 201      },      "memory_total": 8589934592,      "memory_usage": 3758096384,      "mfg": "Samsung",      "model": "Galaxy S23",      "org_id": "c168ddee-c14c-11e5-8e81-1258369c38a9",      "os_type": "Android",      "os_version": "14",      "serial": "R5CX123456A",      "storage_total": 128849018880,      "storage_usage": 52428800000,      "timestamp": 1717027200,      "wifi_band": "5GHz",      "wifi_bssid": "00:11:22:33:44:55",      "wifi_channel": 36,      "wifi_ip": "192.168.1.55",      "wifi_mac": "00:aa:bb:cc:dd:ee",      "wifi_rssi": -58,      "wifi_ssid": "Corp-WiFi"    }  ],  "total": 1}