Skip to content

Get device status reports within specified date-time range
Stable

Request

⚠️ Legacy feature. Android only. Daily and Custom Reports are a legacy feature. For current reporting needs, use the Reports API: GET /report/v0/report-types, POST /report/v0/reports, and GET /report/v0/reports/{report_id}.

Returns per-device status reports organized by device group for a specified date-time range. This endpoint provides a hierarchical view of device health data grouped by Esper device groups, including active, inactive, registered, new, and disabled device counts, with per-device detail records nested inside each group.

About Get Device Report

The device report is a time-scoped snapshot of device status across your fleet, structured by group. Each group entry includes aggregate device counts and an array of DeviceStatusReport objects representing individual devices. Both start_date and end_date are required; only data within that window is returned.

Security
esper_cloud_api_apiKey
Query
start_datestring, (date-time)required

Start date of range in which to retrieve device status reports

end_datestring, (date-time)required

End date of range in which to retrieve device status reports

syncboolean

Sync device status report to specified field

Default:true
fieldsstring

List of fields to add to device status report, comma separated

cURL
curl -i -X GET \
  'https://api.esper.io/_mock/openapi/enterprise/report/device-report/?start_date=2019-08-24T14%3A15%3A22Z&end_date=2019-08-24T14%3A15%3A22Z&sync=true&fields=string' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

successful operation

Bodyapplication/json
Array [
group_idstring, (uuid)
group_namestring
group_pathstring
active_devicesinteger
inactive_devicesinteger
registered_devicesinteger
new_devicesinteger
disabled_devicesinteger
device_status_reportsArray of objects(esper_cloud_api_DeviceStatusReport)
]
Response
[
  {
    "group_id": "306db4e0-7449-4501-b76f-075576fe2d8f",
    "group_name": "string",
    "group_path": "string",
    "active_devices": 0,
    "inactive_devices": 0,
    "registered_devices": 0,
    "new_devices": 0,
    "disabled_devices": 0,
    "device_status_reports": [ … ]
  }
]