GET
Admin user search

Overview

The user-management list view. Combines a free-text query, several status filters, and cursor pagination into a single read. Available to any admin role (SUPER, MODERATOR, FINANCE) — it is read-only.

Authentication

Bearer <accessToken> required, where the token has scope: 'admin' (issued by /admin/auth/mfa-verify). The requireAdmin middleware rejects any user-scope token with 401 UNAUTHENTICATED.
Read-only — all three admin roles (SUPER, MODERATOR, FINANCE) may call this endpoint. No per-route role gate.

Path parameters

None.

Query parameters

Request body

None.

Response — 200 OK

User summary object

Error responses

Example error — 401 UNAUTHENTICATED

See also

  • Ban user — moderation action on a result row.
  • Pagination — the opaque-cursor contract.

curl

Postman

See docs/postman/swappr.postman_collection.json → Admin Users → Search.