---
title: "List users"
method: GET
path: "/users"
tags: ["Users"]
---

# List users

`GET /users`

Returns all users you have access to with profile information. Results are filtered by your account permissions — you'll see yourself and any users connected to you via partnerships.

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

List of users

- UserListResponse
  - `ok` true, required
  - `data` object, required
    - `data` UserSummary[], required
      - `id` integer — Internal user ID
      - `username` string, nullable — User's unique username (from profile)
      - `accountType` 'user' | 'support' | 'admin' | 'superadmin' — Account type
      - `subscriptionTier` 'ultra' | 'pioneer' | 'founder' | 'employee', nullable — Subscription tier (null if no subscription)
      - `league` integer — Current league tier
      - `rank` integer — Leaderboard rank
      - `totalPoints` integer — Lifetime points earned
      - `matchPoints` integer — Points in current match period
      - `profileImage` string, nullable — URL to user's profile image
      - `profileDescription` string, nullable — User's profile bio/description
      - `profileTitle` string, nullable — User's profile title
    - `pagination` Pagination, required
      - `limit` integer, required — Number of records returned
      - `offset` integer, required — Number of records skipped

## Other responses

- `401` — Authentication required or token invalid
- `500` — Internal server error

---

[API](https://skmtc.net/researchanddesire/apis/research-and-desire-api.md) · [All operations](https://skmtc.net/researchanddesire/apis/research-and-desire-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/researchanddesire/research-and-desire-api/versions/9c6dc82bb579/schema)