---
title: "Get User List"
method: GET
path: "/users/{type}"
tags: ["User"]
---

# Get User List

`GET /users/{type}`

Get a list of users by some conditions

## Path parameters

- `type` 'all' | 'admin' | 'in_conf', required

## Query parameters

- `limit` integer
- `offset` integer
- `search` string

## Response `200`

OK

- HandlerResponseAdminUserList
  - `count` integer, required
  - `users` EntityCookedUserForAdmin[], required
    - `badge_color` string, required
    - `badge_name` string, required
    - `comment_count` integer, required
    - `email` string, required
    - `id` integer, required
    - `is_admin` boolean, required
    - `is_in_conf` boolean, required
    - `last_ip` string, required
    - `last_ua` string, required
    - `link` string, required
    - `name` string, required
    - `receive_email` boolean, required

## Other responses

- `403` — Forbidden

## Changes

- **2024-08-28** `4cbf3153581c` — 1 info
  - added the new optional `query` request parameter `search`
- **2024-01-24** `83bbd341664a` — 1 info
  - endpoint added
- **2023-01-28** `6a7a8a92e7c3` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/artalkjs/apis/artalk-api/changes/users/:type/get.md)

---

[API](https://skmtc.dev/artalkjs/apis/artalk-api.md) · [All operations](https://skmtc.dev/artalkjs/apis/artalk-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/artalkjs/artalk-api/revisions/2f927b464019/schema)