---
title: "Получить список"
method: GET
path: "/api-v2/users"
tags: ["Сотрудники"]
---

# Получить список

`GET /api-v2/users`

## Request

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

## Query parameters

- `limit` number
- `offset` number
- `email` string
- `projectId` string

## Response `200`

- UserListDto
  - `paging` PagingMetadata, required
    - `count` number, required: Количество элементов в результате
    - `limit` number, required: Количество элементов на страницу
    - `offset` number, required: Индекс первого элемента страницы
    - `next` boolean, required: Есть ли элементы после данной страницы
  - `content` UserListDtoBase[], required: Список сотрудников
    - `id` string, required: ID объекта
    - `email` string, required: Почтовый ящик сотрудника
    - `isAdmin` boolean: Имеет ли пользователь права администратора
    - `messengerOnly` boolean: Есть ли у пользователя доступ только к мессенджеру
    - `realName` string, required: ФИО
    - `status` string, required: Статус online/offline
    - `lastActivity` number, required: Время последнего действия в системе
    - `customStatus` UserCustomStatusDto
      - `emoji` string, required
      - `text` string, required
    - `hasFakeEmail` boolean: Является ли email пользователя техническим (сгенерированным)
    - `apiData` object: Данные конфигуратора

## Other responses

- `404`

## Changes

- **2026-09-24** `0e55bd2c3698`: 1 info
  - added the optional property `content/items/apiData` to the response with the `200` status

[Operation history](https://skmtc.dev/yougile/apis/yougile-rest-api-v2-0/changes/api-v2/users/get.md)

---

[API](https://skmtc.dev/yougile/apis/yougile-rest-api-v2-0.md) - [All operations](https://skmtc.dev/yougile/apis/yougile-rest-api-v2-0/llms.txt) - [OpenAPI document](https://skmtc.dev/yougile/apis/yougile-rest-api-v2-0/revisions/9452cba35716?raw)