> ## Documentation Index
> Fetch the complete documentation index at: https://docs.arzguard.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Найти сотрудника по ID или никнейму

> Поиск по Discord ID, Telegram ID, ID или ссылке профиля форума, внутреннему UUID пользователя или записи состава, либо никнейму CRM.

Поиск по Discord ID, Telegram ID, ID или ссылке профиля форума, внутреннему UUID пользователя или записи состава, либо никнейму CRM. Требуется право roster:read и доступ к выбранному серверу. Возвращает только текущий состав (active/inactive), включая незарегистрированных сотрудников. При нескольких совпадениях возвращает страницу members. Для продолжения повторите by и value и передайте next\_cursor как cursor. Пустой members означает отсутствие совпадений в доступном составе.

## Доступ

`roster:read`.

**Authorization** `string` *required*

Партнёрский Bearer-токен. Подробнее в разделе [«Авторизация»](https://docs.arzguard.com/cerberus-crm/authentication.md).

## Параметры

**server\_id** `union` *required*

Уникальный номер сервера из GET /api/partner/v1/servers или UUID сервера. Сервер должен входить в выданный боту доступ.

**by** `string` *required*

Тип поиска: discord\_id — ID Discord. Telegram\_id — ID Telegram. Forum\_id — числовой ID форума. Forum\_url — ссылка на профиль форума. Internal\_id — UUID пользователя или записи состава. Nickname — имя сотрудника в CRM. Допустимые значения `discord_id`, `telegram_id`, `forum_id`, `forum_url`, `internal_id`, `nickname`.

**value** `string` *required*

Значение выбранного идентификатора строкой. Для nickname — часть имени в составе CRM (от 2 до 100 символов, без учёта регистра). Для forum\_url — ссылка на профиль настроенного форума. Forum\_id — числовой ID на этом форуме. Для internal\_id — UUID пользователя или записи состава. До 2048 символов.

**limit** `integer`

Максимальное число записей в одной странице. По умолчанию `25`. Диапазон от `1` до `100`.

**cursor** `string`

Курсор из next\_cursor предыдущей страницы. В первом запросе не передавайте. До 36 символов.

## Успешный ответ

HTTP `200`. Запрос выполнен успешно.

**members** `object[] | null` *required*

Сотрудники текущей страницы состава.

**Поля**

**display\_name** `string` *required*

Отображаемое имя сотрудника.

**id** `string` *required*

Идентификатор записи.

**position\_name** `string | null` *required*

Название должности сотрудника.

**status** `string` *required*

Текущее состояние записи.

**user\_id** `string | null` *required*

Идентификатор зарегистрированного пользователя CRM. Null, если аккаунт ещё не зарегистрирован.

**next\_cursor** `string`

Курсор следующей страницы. Пустое значение или отсутствие поля означает, что следующей страницы нет.

## Ошибки

| HTTP | Значение |
| - | - |
| `400` | Некорректные параметры запроса. |
| `401` | Токен отсутствует, недействителен, отозван или не разрешён для этого IP-адреса. |
| `403` | Недостаточно прав у бота или указанного модератора; сервер или функция не входят в выданный доступ. |
| `422` | Данные не прошли проверку формата или ограничений. Подробности находятся в поле errors. |
| `429` | Превышен лимит запросов. Дождитесь интервала, указанного в заголовке Retry-After. |
| `500` | Внутренняя ошибка сервера. |
| `503` | Сервис временно недоступен. Повторите запрос позднее. |

См. [формат ошибок и правила повторов](https://docs.arzguard.com/cerberus-crm/requests-and-errors.md).

## Пример

В примере использованы условные идентификаторы.

```bash cURL theme={null}
curl --request GET \
  --header "Authorization: Bearer $PARTNER_TOKEN" \
  'https://test.crm.arzguard.com/api/partner/v1/servers/102/users/lookup?by=discord_id&value=123456789012345678'
```

```json HTTP 200, сокращённый ответ theme={null}
{
  "members": []
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.