---
title: "Get Device Stats Analytics"
method: GET
path: "/admin/analytics/device"
tags: ["admin"]
---

# Get Device Stats Analytics

`GET /admin/analytics/device`

Get device breakdown analytics.

Shows desktop/mobile/tablet split with trend over time.

## Query parameters

- `start_date` string, required — Start date (ISO format)
- `end_date` string, required — End date (ISO format)
- `group_by` string — Time grouping: 'day', 'week', or 'month'

## Response `200`

Successful Response

- DeviceStatsAnalyticsResponse — Response for device stats analytics endpoint.
  - `metrics` DeviceStatMetric[], required
    - `label` string, required
    - `current` number, required
    - `previous` number, required
    - `is_percentage` boolean
  - `by_period` DevicePeriodData[], required
    - `period` string, required
    - `desktop` integer, required
    - `mobile` integer, required
    - `tablet` integer, required
    - `total` integer, required
    - `mobile_pct` number, required
  - `group_by` string, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/stardrift/apis/fastapi.md) · [All operations](https://skmtc.dev/stardrift/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/stardrift/fastapi/revisions/00746572572a/schema)
