---
title: "Get device status reports within specified date-time range"
method: GET
path: "/enterprise/report/device-report/"
tags: ["esper_cloud_api_Daily and Custom Reports"]
---

# Get device status reports within specified date-time range

`GET /enterprise/report/device-report/`

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

## Query parameters

- `start_date` string, date-time, required
- `end_date` string, date-time, required
- `sync` boolean
- `fields` string

## Response `200`

successful operation

- object[]
  - `group_id` string, uuid
  - `group_name` string
  - `group_path` string
  - `active_devices` integer
  - `inactive_devices` integer
  - `registered_devices` integer
  - `new_devices` integer
  - `disabled_devices` integer
  - `device_status_reports` EsperCloudApiDeviceStatusReport[]
    - `device_id` string, uuid
    - `device_name` string
    - `alias_name` string, nullable
    - `device_model` string
    - `device_brand` string
    - `android_version` string
    - `serial_number` string
    - `is_new` boolean
    - `last_known_location` string
    - `days_active` integer
    - `status` string — choices- ACTIVE / INACTIVE / DISABLED
    - `inactive_since_three_days` boolean

## Other responses

- `401` — Authorization information is missing or invalid.
- `404` — Not Found.
- `500` — Internal server error

---

[API](https://skmtc.net/esper/apis/esper-api-reference.md) · [All operations](https://skmtc.net/esper/apis/esper-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/esper/esper-api-reference/revisions/e1f64cbb488e/schema)