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

# List users

`GET /users/`

Use this method to list users.

## Query parameters

- `active` boolean
- `date_joined_gt` string, date-time
- `date_joined_gte` string, date-time
- `date_joined_lt` string, date-time
- `date_joined_lte` string, date-time
- `groups` integer[]
- `has_face` boolean
- `id_in` integer[]
- `language` 'en-us' | 'es' | 'ru'
- `limit` string
- `ordering` string
- `page` string
- `primary_group` integer[]
- `real_name_contains` string
- `username_contains` string

## Response `200`

- PaginatedUserList
  - `next_page` string, nullable
  - `prev_page` string, nullable
  - `results` User[]
    - `id` integer, required
    - `active` boolean, required
    - `created_date` string, date-time, required
    - `groups` integer[]
    - `modified_date` string, date-time, required — Object modification date
    - `permissions` string[], required
    - `real_name` string, required
    - `name` string, required
    - `comment` string — Extended description of the user, up to 2048 chars
    - `camera_group_permissions` object, required
    - `watch_list_permissions` object, required
    - `group_permissions` object, required
    - `primary_group` integer, required
    - `language` 'en-us' | 'es' | 'ru'
    - `has_face` boolean, required — User photo is provided
    - `face_cover` string, nullable
    - `ad_user` boolean, required — User is registered in Active Directory

---

[API](https://skmtc.dev/ntechlab/apis/internal-api-documentation.md) · [All operations](https://skmtc.dev/ntechlab/apis/internal-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ntechlab/internal-api-documentation/revisions/fe217a895bc7/schema)