---
title: "List Device Clients"
method: GET
path: "/api/v1/iam/personal_devices/{device_id}/clients"
tags: ["Personal Device"]
---

# List Device Clients

`GET /api/v1/iam/personal_devices/{device_id}/clients`

ListDeviceClients returns the app clients registered on a device, one page at
 a time. A device can accrue many app clients over time, so the clients are
 served from this dedicated paginated endpoint rather than inlined on the
 device.

## Path parameters

- `device_id` string, required — The device identity (a base64url-encoded SHA-256 thumbprint of the device root key) whose clients to list.

## Response `200`

Successful response

- C1ApiIamV1PersonalDeviceServiceListDeviceClientsResponse — The PersonalDeviceServiceListDeviceClientsResponse message.
  - `clients` C1ApiIamV1PersonalDeviceClient[], nullable — The app clients registered on the device.
    - `clientId` string — The full client_id of the device credential.
    - `clientName` string — The human-friendly client name from its registration metadata.
    - `consumerKeyId` string — The stable identity of this client's per-app key.
    - `createdAt` string, date-time, nullable
    - `deviceOs` string — The device operating system captured for this client, e.g. "macos-14.5".
    - `deviceSurface` string — The device surface captured for this client, e.g. "macos-desktop".
    - `displayName` string — The display name of the device credential.
    - `id` string — The unique ID of the device client (the local part of client_id).
    - `lastUsedAt` string, date-time, nullable
    - `softwareId` string — An identifier for the client software, from its registration metadata.
    - `softwareVersion` string — The version of the client software, from its registration metadata.
  - `nextPageToken` string — A token to retrieve the next page of results, or empty if there are no more.

---

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