---
title: "Get Users Paginated"
method: GET
path: "/admin/users"
tags: ["Admin"]
---

# Get Users Paginated

`GET /admin/users`

## Request

- Base URL: `https://api.oxlo.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.oxlo.ai/admin/users`
- Auth: HTTP bearer

Get paginated list of users including total requests and tokens.

## Query parameters

- `limit` integer
- `offset` integer
- `search` string, nullable
- `promo_filter` string, nullable
- `country_filter` string, nullable
- `admin_only` boolean
- `interest_only` boolean
- `plan_filter` string, nullable
- `sort_by` string
- `sort_order` string

## Response `200`

Successful Response

- PaginatedUsersResponse
  - `total` integer, required
  - `limit` integer, required
  - `offset` integer, required
  - `users` UserAdminView[], required
    - `id` string, required
    - `email` string, required
    - `username` string, nullable, required
    - `name` string, nullable, required
    - `company_name` string, nullable, required
    - `country_code` string, nullable, required
    - `promo_code_used` string, nullable, required
    - `signup_number` integer, nullable, required
    - `access_group` integer, nullable, required
    - `email_verified` boolean, required
    - `profile_completed` boolean, required
    - `is_superuser` boolean, required
    - `auth_provider` string, nullable, required
    - `login_count` integer, required
    - `last_login_at` string, date-time, nullable, required
    - `detected_country` string, nullable, required
    - `detected_country_code` string, nullable, required
    - `status` string, required
    - `created_at` string, date-time, required
    - `is_banned` boolean, required
    - `total_requests` integer, required
    - `total_tokens` integer, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/oxlo/apis/oxlo-backend.md) - [All operations](https://skmtc.dev/oxlo/apis/oxlo-backend/llms.txt) - [OpenAPI document](https://skmtc.dev/oxlo/apis/oxlo-backend/revisions/bc2ecdc94f31?raw)