---
title: "Users List"
method: GET
path: "/api/v1/admin/users"
tags: ["Admin Dashboard"]
---

# Users List

`GET /api/v1/admin/users`

## Request

- Base URL: `https://backend.caspr.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://backend.caspr.ai/api/v1/admin/users`
- Auth: OAuth 2
  - Password
  - Token URL: `token`

All users (searchable, paginated), sorted by usage in the selected period.

## Query parameters

- `range` string: Preset: today | 2d | 7d | 30d | all (ignored if start_date/end_date set)
- `start_date` string, nullable: Custom window start (YYYY-MM-DD or ISO datetime). Overrides range presets.
- `end_date` string, nullable: Custom window end (YYYY-MM-DD or ISO datetime). Defaults to now.
- `q` string, nullable: Search user name or email
- `sort` string: spend | chats | last_active
- `page` integer
- `page_size` integer
- `active_only` boolean: If true, only users with activity in the period

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/caspr/apis/casper-api.md) - [All operations](https://skmtc.dev/caspr/apis/casper-api/llms.txt) - [OpenAPI document](https://skmtc.dev/caspr/apis/casper-api/revisions/f9765e3aa00c?raw)