---
title: "List devices (superuser)"
method: GET
path: "/v1/{dongleId}/devices"
tags: ["superuser"]
---

# List devices (superuser)

`GET /v1/{dongleId}/devices`

## Request

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

List devices owned or readable by specified user

## Response `200`

JSON array of device objects

- Device[]
  - `dongle_id` string, required: A unique 16-character hexadecimal string. Can represent a device or a user.
  - `alias` string, required: Device nickname
  - `serial` string, required: Device serial number
  - `athena_host` string, nullable: Last connected athena server hostname
  - `last_athena_ping` integer: Unix timestamp of last athena ping
  - `ignore_uploads` boolean, nullable: Uploads are ignored from this device
  - `is_paired` boolean, required: Device has an owner
  - `is_owner` boolean: Authenticated user has write-access to the device
  - `public_key` string, nullable, required: 2048-bit public RSA key
  - `prime` boolean, required: Device has a prime subscription
  - `prime_type` 0 | 1 | 2 | 3 | 4, required: Prime subscription type - 0 = None - 1 = Magenta - 2 = Lite - 3 = Blue - 4 = Magenta New
  - `trial_claimed` boolean, nullable, required: Device prime trial is claimed
  - `device_type` 'app' | 'neo' | 'panda' | 'two' | 'freon' | 'pc' | 'three', required: Device type
  - `last_gps_time` integer, nullable, required: Unix timestamp, in milliseconds
  - `last_gps_lat` number, nullable, required: Latitude, in decimal degrees
  - `last_gps_lng` number, nullable, required: Longitude, in decimal degrees
  - `last_gps_accuracy` number, nullable, required: Accuracy, in metres
  - `last_gps_speed` number, nullable, required: Speed, in metres per second
  - `last_gps_bearing` number, nullable, required: Direction angle, in degrees from north
  - `openpilot_version` string, nullable: openpilot version
  - `sim_id` string, nullable, required: Last known SIM ID of the device

## Changes

- **2022-12-03** `d13c9189b880`: 20 info
  - the response optional property `items/athena_host` became read-only for the status `200`
  - the response optional property `items/ignore_uploads` became read-only for the status `200`
  - the response optional property `items/is_owner` became read-only for the status `200`
  - the response optional property `items/last_athena_ping` became read-only for the status `200`
  - …16 more
- **2022-11-27** `5b1478ce801f`: 1 info
  - api tag `superuser` added
- **2022-11-27** `04af598547de`: 1 info
  - the endpoint scheme security `AuthUser` was added to the API

[Operation history](https://skmtc.dev/comma/apis/comma-api/changes/v1/:dongleId/devices/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)