ESesper
esper_cloud_api_Device Telemetry

Get list of device tiles reports

⚠️ Android only. This endpoint returns data for Android devices only. For device-level reporting across platforms, use the Reports API (POST /report/v0/reports).

Retrieves a paginated list of device tile records for the enterprise's fleet.

Each record is a per-device summary that combines device details, network information, battery level, and security state. Supports a wide set of filters, including group, model, Android version, battery level, security status, and last-seen time.

About Device Tiles A device tile is a snapshot of one device's status in a single record, convenient for fleet overviews and filtered lists. It's a summary view; for detailed or exportable device data, use the Reports API.

Key Fields / Query Parameters

  • group, group_multi, group_name — Filter by device group ID or name
  • battery_level_gte / battery_level_lte — Filter by battery level range
  • security_status, at_risk — Filter by security state
  • last_seen_gt / last_seen_lt — Filter by when the device last checked in
  • model, android_version, dpc_version — Filter by hardware and software versions
  • battery_level, security_state, network_info — Key fields in each returned record

Common Use Cases

  • Finding devices with low battery or a risky security state
  • Listing devices in a group that haven't checked in recently
  • Building a filtered fleet overview by model or Android version

Best Practices

  • Combine filters to keep responses small on large fleets
  • Use next to page through results instead of requesting everything at once
  • Use the Reports API when you need full device-level data or exports

Workflow

  1. Choose filters for the devices you need
  2. Call this endpoint with enterprise_id and those filters
  3. Follow next until it's null
get/v1/enterprise/{enterprise_id}/report/device-tiles/

Request

  • Base URL
    https://develop-api.esper.cloud/api
  • URL
    https://develop-api.esper.cloud/api/v1/enterprise/{enterprise_id}/report/device-tiles/
  • Auth
    HTTP bearer

Path parameters

enterprise_idstring required

A UUID string identifying this enterprise.

Query parameters

stateinteger

Filter device-tile reports by state.

created_on_gtstring datetime

Filter device-tile reports created after a given timestamp.

created_on_ltstring datetime

Filter 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_status1 | 10 | 20 | 30 | 100

Following are the Security States and their description

  * 1 = SECURE
  * 10 = LOW_RISK
  * 20 = MEDIUM_RISK
  * 30 = HIGH_RISK
  * 100 = DEVICE_STATE_UNSPECIFIED
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

Add group names to filter by comma separating

Filter device-tile reports using multiple group names.

group_multistring uuid

Add group UUID to filter by comma separating

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

group_multi_immediatestring

Filter device-tile reports by immediate groups

group_nullstring boolean

Allowed values are True, False, true, false, 1, 0.

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

List of android versions- comma separated.

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

List of network types, comma separated.

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

List of templates, comma separated.

Filter device-tile reports by multiple templates.

policystring

Filter device-tile reports by policy name.

policy_multistring

List of policy names, comma separated.

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

City or state can be used to filter location.

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.

Response

successful operation

countinteger required
nextstring url nullable
previousstring url nullable

Changes

No recorded changes to this operation across all 6 revisions of this API.