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

# List users

`GET /users`

## Request

- Base URL: `https://dashboard.researchanddesire.com/api/v1`
- URL: `https://dashboard.researchanddesire.com/api/v1/users`
- Auth: one of:
  - HTTP bearer
  - OAuth 2
    - Authorization code: `/oauth/authorize`
    - Token URL: `/oauth/token` scopes: `profile:read`

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

## Changes

- **2026-09-22** `2411203b3c10`: 2 info
  - the endpoint scheme security `bearerAuth` was added to the API
  - the endpoint scheme security `oauth2` was added to the API

[Operation history](https://skmtc.dev/researchanddesire/apis/research-and-desire-api/changes/users/get.md)

---

[API](https://skmtc.dev/researchanddesire/apis/research-and-desire-api.md) - [All operations](https://skmtc.dev/researchanddesire/apis/research-and-desire-api/llms.txt) - [OpenAPI document](https://skmtc.dev/researchanddesire/apis/research-and-desire-api/revisions/682fc4d7f6d5?raw)