---
title: "Search users"
method: POST
path: "/search/users"
tags: ["search"]
---

# Search users

`POST /search/users`

Lookup one or more users by ID and/or username.

Use this for quick user hydration in:
- conversation lists
- activity feeds
- review lists
- any UI that only has IDs/usernames and needs profile summaries

Behavior:
- Accepts a mix of `ids` and `usernames`.
- Returns matched user records in one round-trip.

Good to know:
- Responses are cached briefly for repeated lookup payloads.

## Request body

- object
  - `ids` string[] — List of user IDs to lookup
  - `usernames` string[] — List of usernames to lookup

## Response `200`

List of users

- UserSummary[] — Array of users with their IDs and usernames.
  - `id` string, required — Unique identifier for the user
  - `username` string, required — Public username of the user
  - `joined` string, date-time — ISO timestamp when the user account was created
  - `avatar` string, uri — URL to the user's avatar image
  - `cover` string, uri — URL to the user's cover image
  - `profile` string — Information about the user
  - `reviews` integer, required — Total number of reviews the user has received
  - `rating` number, required — Confidence-based rating between 0 and 5
  - `score` number, required — Average rating between 0 and 5
  - `sales` integer, required — Total number of sales the user has made
  - `purchases` integer, required — Total number of purchases the user has made

---

[API](https://skmtc.net/managem/apis/managem-api.md) · [All operations](https://skmtc.net/managem/apis/managem-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/managem/managem-api/versions/6367b514f6ea/schema)