---
title: "List staff Fans search results"
method: GET
path: "/api/admin/users"
tags: ["Admin"]
---

# List staff Fans search results

`GET /api/admin/users`

## Request

- Base URL: `https://app.d-sports.org`
- URL: `https://app.d-sports.org/api/admin/users`
- Auth: HTTP bearer

Requires Clerk authentication and isAdmin (admin or superadmin). Moderators, club-only staff and regular fans receive 403; anonymous callers receive 401. Returns the existing staff Fans list with additive integer dsportsCash, including zero, without ledger history. Consumed by d-sports-engage-native#1239. Existing search, sorting and pagination are unchanged.

## Query parameters

- `page` integer
- `limit` integer
- `search` string
- `sortBy` string
- `sortOrder` string

## Response `200`

Paginated Fans with balances visible only to platform admins.

- object
  - `success` true, required
  - `data` object, required
    - `users` object[], required
      - `id` string, required
      - `email` string, nullable, required
      - `name` string, nullable, required
      - `handle` string, nullable, required
      - `profileUrl` string, required
      - `profileUrlThumbhash` string, nullable, required
      - `createdAt` string, date-time, required
      - `onboardingComplete` boolean, required
      - `dsportsCash` integer, required: Current User.dsportsCash balance; zero is returned explicitly.
      - `roles` string[], required: Combined role strings and display label strings.
      - `labels` object[], required
        - `label` string, required
      - `_count` object, required
        - `followers` integer, required
        - `following` integer, required
      - `isAdmin` boolean, required
      - `isSuperAdmin` boolean, required
      - `isModerator` boolean, required
    - `pagination` object, required
      - `page` integer, required
      - `limit` integer, required
      - `totalCount` integer, required
      - `totalPages` integer, required
      - `hasMore` boolean, required

## Other responses

- `401`: Missing Clerk authentication (UNAUTHORIZED).
- `403`: Not an admin or superadmin (FORBIDDEN), including moderators and club-only staff.
- `500`: Failed to fetch fans (INTERNAL_ERROR); logged through logger.error.

## Changes

- **2026-11-18** `6de639c52609`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/changes/api/admin/users/get.md)

---

[API](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api.md) - [All operations](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/llms.txt) - [OpenAPI document](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/revisions/63735cf90a04?raw)
