---
title: "Search Users"
method: GET
path: "/users/search"
tags: ["users", "users"]
---

# Search Users

`GET /users/search`

Search users by email or display name, filtered to the caller's email domain.

## Query parameters

- `q` string

## Response `200`

Successful Response

- UserSearchResponse
  - `users` UserProfileResponse[], required
    - `user_id` string, required
    - `display_name` string, required
    - `avatar_url` string, nullable, required
    - `email` string, nullable, required
    - `needs_onboarding` boolean
    - `current_org` CurrentOrg — The viewer's own org — adds the fields the renderer needs to render settings without a second round-trip: the toggle value plus the viewer's role for owner-gated UI.
      - `id` string, required
      - `name` string, required
      - `claimed_domain` string, nullable
      - `external_sharing_enabled` boolean, required
      - `viewer_role` 'owner' | 'admin' | 'member', required
      - `is_personal` boolean, required — True when the org has no claimed domain — i.e. it is a personal/solo org.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/tryscott/apis/one-shot-api.md) · [All operations](https://skmtc.dev/tryscott/apis/one-shot-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/tryscott/one-shot-api/revisions/28bdface01df/schema)