Device Telemetry

Get list of device locations

Returns list of device locations

SecurityapiKey
Request
path Parameters
enterprise_id
required
string

A UUID string identifying this enterprise.

query Parameters
limit
integer

Number of results to return per page.

offset
integer

The initial index from which to return the results.

Responses
200

successful operation

401

Authorization information is missing or invalid.

404

Not Found.

500

Internal server error

get/v1/enterprise/{enterprise_id}/report/location/
Request samples
Response samples
application/json
{
  • "count": 0,
  • "next": "string",
  • "previous": "string",
  • "results": [
    ]
}

Get location of specific device

Returns location information of device

SecurityapiKey
Request
path Parameters
enterprise_id
required
string

A UUID string identifying this enterprise.

location_id
required
integer

An integer identifying the location.

Responses
200

successful operation

401

Authorization information is missing or invalid.

404

Not Found.

500

Internal server error

get/v1/enterprise/{enterprise_id}/report/location/{location_id}/
Request samples
Response samples
application/json
{
  • "id": 0,
  • "latitude": 0,
  • "longitude": 0,
  • "altitude": 0,
  • "city": "string",
  • "status": "string",
  • "country": "string",
  • "zipcode": 0,
  • "last_updated_on": "2019-08-24T14:15:22Z",
  • "device": "string",
  • "enterprise": "string"
}

Get list of device tiles reports

Returns list of device tiles reports

SecurityapiKey
Request
path Parameters
enterprise_id
required
string

A UUID string identifying this enterprise.

query Parameters
state
integer

Filter device-tile reports by state.

created_on_gt
string <datetime>

Filter device-tile reports created after a given timestamp.

created_on_lt
string <datetime>

Flter device-tile reports created before a given timestamp.

provisioned_on_gt
string <datetime>

Filter device-tile reports provisioned after a given timestamp.

provisioned_on_lt
string <datetime>

Filter device-tile reports provisioned before a given timestamp.

updated_on_gt
string <datetime>

Filter device-tile reports updated after a given timestamp.

updated_on_lt
string <datetime>

Filter device-tile reports updated before a given timestamp.

last_seen_gt
string <datetime>

Filter device-tile reports last seen after a given timestamp.

last_seen_lt
string <datetime>

Filter device-tile reports last seen before a given timestamp.

battery_level_gte
number <double>

Filter device-tile reports by battery level greater than given battery level.

battery_level_lte
number <double>

Filter device-tile reports by battery level lower than given battery level.

at_risk
boolean

Filter device-tile reports by whether they are at risk.

security_status
integer <int32> (SecurityStatesEnum)

Following are the Security States and their description

  * 1 = SECURE
  * 10 = LOW_RISK
  * 20 = MEDIUM_RISK
  * 30 = HIGH_RISK
  * 100 = DEVICE_STATE_UNSPECIFIED
Enum: 1 10 20 30 100
status
string

Filter device-tile reports by status.

group
string <uuid>

Filter device-tile reports by group.

group_name
string

Filter device-tile reports by group name.

group_name_multi
string

Filter device-tile reports using multiple group names.

group_multi
string <uuid>

Filter device-tile reports by using multiple group ID's

group_multi_immediate
string

Filter device-tile reports by immediate groups

group_null
string <boolean>

Filter device-tile reports by availability of group. True returns device-tiles with no group. False returns device-tiles with group.

imei
string

Filter device-tile reports by imei.

name
string

Filter device-tile reports by device name.

recently_added
boolean

Filter device-tile reports by recently added.

is_gms
boolean

Filter device-tile reports for gms devices.

tags
string

Filter device-tile reports by tag.

is_geofence_applied
boolean

Filter device-tile reports by geofence application.

serial
string

Filter device-tile reports by device serial id.

android_version
integer

Filter device-tile reports by android version.

android_version_multi
integer

Filter device-tile reports by multiple android versions.

wifi_ssid
string

Filter device-tile reports by wifi-ssid.

network_type
string

Filter device-tile reports by network type.

network_type_multi
string

Filter device-tile reports by multiple network types.

model
string

Filter device-tile reports by device model.

template
string

Filter device-tile reports by template.

template_multi
string

Filter device-tile reports by multiple templates.

policy
string

Filter device-tile reports by policy name.

policy_multi
string

Filter device-tile reports by multiple policies.

policy_null
boolean

Filter device-tile reports by null-value policy.

dpc_version
string

Filter device-tile reports by DPC version.

location
string

Filter device-tile reports by location.

active_connection
boolean

Filter device-tile reports by active connection status.

device_type
string

Filter device-tile reports by device type.

has_seamlessInfo
boolean

Filter device-tile reports by seamless information.

Responses
200

successful operation

401

Authorization information is missing or invalid.

404

Not Found.

500

Internal server error

get/v1/enterprise/{enterprise_id}/report/device-tiles/
Request samples
Response samples
application/json
{
  • "count": 0,
  • "next": "string",
  • "previous": "string",
  • "results": [
    ]
}

Get instance of device tiles report

Returns instance of device tiles report

SecurityapiKey
Request
path Parameters
enterprise_id
required
string

A UUID string identifying this enterprise.

device_tiles_id
required
integer

An integer representing the device tile report.

Responses
200

successful operation

401

Authorization information is missing or invalid.

404

Not Found.

500

Internal server error

get/v1/enterprise/{enterprise_id}/report/device-tiles/{device_tiles_id}/
Request samples
Response samples
application/json
{
  • "id": 0,
  • "device": {
    },
  • "network_info": {
    },
  • "model": "string",
  • "location": { },
  • "battery_level": 0,
  • "security_state": "string",
  • "security_reason": "string",
  • "security_advise": "string",
  • "wifi_ssid": "string",
  • "updated_on": "2019-08-24T14:15:22Z",
  • "created_on": "2019-08-24T14:15:22Z",
  • "is_active": true,
  • "is_gms": true,
  • "status_id": 0,
  • "serial_no": "string",
  • "android_version": 0,
  • "eea_version": "string",
  • "dpc_version": "string",
  • "location_city": "string",
  • "network_type": "string",
  • "enterprise": "string",
  • "icon": "string"
}

Get status metrics report for enterprise

Returns status metrics report for enterprise

SecurityapiKey
Request
path Parameters
enterprise_id
required
string

A UUID string identifying this enterprise.

Responses
200

successful operation

401

Authorization information is missing or invalid.

404

Not Found.

500

Internal server error

get/v1/enterprise/{enterprise_id}/report/status-metrics/
Request samples
Response samples
application/json
{
  • "active": 0,
  • "in_active": 0,
  • "low_risk": 0,
  • "high_risk": 0,
  • "medium_risk": 0,
  • "secure": 0,
  • "low_battery": 0,
  • "under_provisioning": 0,
  • "recently_added": 0,
  • "unspecified": 0,
  • "total_devices_under_risk": 0
}

Get status metrics report for enterprise v2

Returns status metrics report for enterprise

SecurityapiKey
Request
path Parameters
enterprise_id
required
string

A UUID string identifying this enterprise.

Responses
200

successful operation

401

Authorization information is missing or invalid.

500

Internal server error

get/v2/enterprise/{enterprise_id}/report/status-metrics
Request samples
Response samples
application/json
{
  • "last_seen": {
    },
  • "low_risk": 0,
  • "high_risk": 0,
  • "medium_risk": 0,
  • "secure": 0,
  • "low_battery": 0,
  • "under_provisioning": 0,
  • "recently_added": 0,
  • "unspecified": 0,
  • "total_devices_under_risk": 0
}