---
title: "NOTE: Only shows devices for the current user."
method: POST
path: "/api/v1/search/iam/personal_devices"
tags: ["Personal Device"]
---

# NOTE: Only shows devices for the current user.

`POST /api/v1/search/iam/personal_devices`

Search returns the calling user's registered devices, ordered by display name.
 By default only active devices are returned; use the status filter to include
 revoked devices. Optionally filter by a display-name query.

## Request body

- C1ApiIamV1PersonalDeviceServiceSearchRequest — The PersonalDeviceServiceSearchRequest message.
  - `pageSize` integer — The maximum number of results to return per page.
  - `pageToken` string — A pagination token returned from a previous Search call.
  - `query` string — An optional case-insensitive filter on the device display name.
  - `statusFilter` 'PERSONAL_DEVICE_STATUS_FILTER_UNSPECIFIED' | 'PERSONAL_DEVICE_STATUS_FILTER_ACTIVE' | 'PERSONAL_DEVICE_STATUS_FILTER_REVOKED' | 'PERSONAL_DEVICE_STATUS_FILTER_ALL' — Which device statuses to return. Defaults to active devices only.

## Response `200`

Successful response

- C1ApiIamV1PersonalDeviceServiceSearchResponse — The PersonalDeviceServiceSearchResponse message.
  - `list` C1ApiIamV1PersonalDevice[], nullable — The devices the calling user has registered, matching the search criteria.
    - `createdAt` string, date-time, nullable
    - `deviceId` string — The stable device identity: a base64url-encoded SHA-256 thumbprint of the device's root public signing key.
    - `deviceOs` string — The device operating system, e.g. "macos-14.5".
    - `deviceSurface` string — The device surface, e.g. "macos-desktop".
    - `displayName` string — The human-friendly device label, defaulted from the first app's name at registration. Devices are listed sorted by this name. Mutable via UpdateDevice.
    - `status` 'PERSONAL_DEVICE_STATUS_UNSPECIFIED' | 'PERSONAL_DEVICE_STATUS_ACTIVE' | 'PERSONAL_DEVICE_STATUS_REVOKED' — The device's lifecycle status. Revoked devices are retained for audit and are returned by Search only when the status filter requests them.
    - `updatedAt` string, date-time, nullable
    - `userId` string — The ID of the user this device is bound to (the approving user).
  - `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)