---
title: "Device driving statistics"
method: GET
path: "/v1.1/devices/{dongleId}/stats"
tags: ["devices"]
---

# Device driving statistics

`GET /v1.1/devices/{dongleId}/stats`

## Request

- Base URL: `https://api.comma.ai`
- URL: `https://api.comma.ai/v1.1/devices/{dongleId}/stats`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Returns aggregate driving statistics for a device over the past 7 days and all time.

## Response `200`

JSON object containing driving statistics

- object
  - `all` DrivingStatistics, required: Summary of drives over a period of time
    - `distance` number, required: Sum of distance driven in time period, in miles
    - `minutes` integer, required: Sum of time driven in time period, in minutes
    - `routes` integer, required: Count of routes in time period
  - `week` DrivingStatistics, required: Summary of drives over a period of time
    - `distance` number, required: Sum of distance driven in time period, in miles
    - `minutes` integer, required: Sum of time driven in time period, in minutes
    - `routes` integer, required: Count of routes in time period

## Changes

- **2022-11-27** `672f13e0c42c`: 2 info
  - the response property `all` became required for the status `200`
  - the response property `week` became required for the status `200`
- **2022-11-27** `c76b9e672796`: 2 info
  - api tag `devices` added
  - api tag `routes` removed
- **2022-11-27** `5b1478ce801f`: 1 info
  - api tag `routes` added
- **2022-11-27** `04af598547de`: 2 info
  - the endpoint scheme security `AuthDevice` was added to the API
  - the endpoint scheme security `AuthUser` was added to the API

[Operation history](https://skmtc.dev/comma/apis/comma-api/changes/v1.1/devices/:dongleId/stats/get.md)

---

[API](https://skmtc.dev/comma/apis/comma-api.md) - [All operations](https://skmtc.dev/comma/apis/comma-api/llms.txt) - [OpenAPI document](https://skmtc.dev/comma/apis/comma-api/revisions/24f7dbc922ad?raw)