Skip to content

Get list of device tiles reports
Stable

Request

Returns list of device tiles reports

Security
esper_cloud_api_apiKey
Path
enterprise_idstringrequired

A UUID string identifying this enterprise.

Query
stateinteger

Filter device-tile reports by state.

created_on_gtstring, (datetime)

Filter device-tile reports created after a given timestamp.

created_on_ltstring, (datetime)

Flter device-tile reports created before a given timestamp.

provisioned_on_gtstring, (datetime)

Filter device-tile reports provisioned after a given timestamp.

provisioned_on_ltstring, (datetime)

Filter device-tile reports provisioned before a given timestamp.

updated_on_gtstring, (datetime)

Filter device-tile reports updated after a given timestamp.

updated_on_ltstring, (datetime)

Filter device-tile reports updated before a given timestamp.

last_seen_gtstring, (datetime)

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

last_seen_ltstring, (datetime)

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

battery_level_gtenumber, (double)

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

battery_level_ltenumber, (double)

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

at_riskboolean

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

security_statusinteger, (int32)(esper_cloud_api_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:1102030100
statusstring

Filter device-tile reports by status.

groupstring, (uuid)

Filter device-tile reports by group.

group_namestring

Filter device-tile reports by group name.

group_name_multistring

Filter device-tile reports using multiple group names.

group_multistring, (uuid)

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

group_multi_immediatestring

Filter device-tile reports by immediate groups

group_nullstring, (boolean)

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

imeistring

Filter device-tile reports by imei.

namestring

Filter device-tile reports by device name.

recently_addedboolean

Filter device-tile reports by recently added.

is_gmsboolean

Filter device-tile reports for gms devices.

tagsstring

Filter device-tile reports by tag.

is_geofence_appliedboolean

Filter device-tile reports by geofence application.

serialstring

Filter device-tile reports by device serial id.

android_versioninteger

Filter device-tile reports by android version.

android_version_multiinteger

Filter device-tile reports by multiple android versions.

wifi_ssidstring

Filter device-tile reports by wifi-ssid.

network_typestring

Filter device-tile reports by network type.

network_type_multistring

Filter device-tile reports by multiple network types.

modelstring

Filter device-tile reports by device model.

templatestring

Filter device-tile reports by template.

template_multistring

Filter device-tile reports by multiple templates.

policystring

Filter device-tile reports by policy name.

policy_multistring

Filter device-tile reports by multiple policies.

policy_nullboolean

Filter device-tile reports by null-value policy.

dpc_versionstring

Filter device-tile reports by DPC version.

locationstring

Filter device-tile reports by location.

active_connectionboolean

Filter device-tile reports by active connection status.

device_typestring

Filter device-tile reports by device type.

has_seamlessInfoboolean

Filter device-tile reports by seamless information.

cURL
curl -i -X GET \
  'https://api.esper.io/_mock/openapi/v1/enterprise/{enterprise_id}/report/device-tiles/?state=0&created_on_gt=string&created_on_lt=string&provisioned_on_gt=string&provisioned_on_lt=string&updated_on_gt=string&updated_on_lt=string&last_seen_gt=string&last_seen_lt=string&battery_level_gte=0.1&battery_level_lte=0.1&at_risk=true&security_status=1&status=string&group=497f6eca-6276-4993-bfeb-53cbbbba6f08&group_name=string&group_name_multi=string&group_multi=497f6eca-6276-4993-bfeb-53cbbbba6f08&group_multi_immediate=string&group_null=string&imei=string&name=string&recently_added=true&is_gms=true&tags=string&is_geofence_applied=true&serial=string&android_version=0&android_version_multi=0&wifi_ssid=string&network_type=string&network_type_multi=string&model=string&template=string&template_multi=string&policy=string&policy_multi=string&policy_null=true&dpc_version=string&location=string&active_connection=true&device_type=string&has_seamlessInfo=true' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

successful operation

Bodyapplication/json
countintegerrequired
nextstring or null, (url)
previousstring or null, (url)
resultsArray of objects(esper_cloud_api_DeviceTiles)required
Response
{
  "count": 0,
  "next": "string",
  "previous": "string",
  "results": [
    { … }
  ]
}