Skip to content

Get list of device tiles reports
Stable

Request

⚠️ 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
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)

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_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://develop-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": [
    { … }
  ]
}