---
title: "NOTE: Searches personal clients for all users"
method: POST
path: "/api/v1/search/iam/personal_clients"
tags: ["Personal Client"]
---

# NOTE: Searches personal clients for all users

`POST /api/v1/search/iam/personal_clients`

Search finds personal client credentials across all users, with optional filtering by query text or user.
 Request a modest page_size (≤25) to keep responses small.

## Request body

- C1ApiIamV1PersonalClientSearchServiceSearchRequest — The PersonalClientSearchServiceSearchRequest 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 — A text query to filter personal clients by display name.
  - `users` C1ApiUserV1UserRef[], nullable — Filter results to personal clients owned by the specified users.
    - `id` string — The id of the user.

## Response `200`

Successful response

- C1ApiIamV1PersonalClientSearchServiceSearchResponse — The PersonalClientSearchServiceSearchResponse message.
  - `list` C1ApiIamV1PersonalClient[], nullable — The list of personal client credentials matching the search criteria.
    - `allowSourceCidr` string[], nullable — If set, only allows the CIDRs in the array to use the credential. Accepts IPv4 (e.g. 10.0.0.0/24) or IPv6 (e.g. 2001:db8::/32) CIDRs.
    - `clientId` string — The clientID of the credential.
    - `createdAt` string, date-time, nullable
    - `deletedAt` string, date-time, nullable
    - `displayName` string — The display name of the personal client credential.
    - `expiresTime` string, date-time, nullable
    - `id` string — The unique ID of the personal client credential.
    - `lastUsedAt` string, date-time, nullable
    - `scopedRoles` string[], nullable — scoped_roles provides a list of IAM Roles that this OAuth2 Client's API permissions are reduced to. The permissions granted to OAuth2 Client are AND'ed against the owning User's own permissions.
    - `updatedAt` string, date-time, nullable
    - `userId` string — The ID of the user that this credential is created for.
  - `nextPageToken` string — A token to retrieve the next page of results, or empty if there are no more results.

---

[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)