---
title: "Получить участников кабинета"
method: GET
path: "/api/v1/settings/members"
tags: ["Settings members"]
---

# Получить участников кабинета

`GET /api/v1/settings/members`

## Request

- Base URL: `https://erp.akeda.ru`
- URL: `https://erp.akeda.ru/api/v1/settings/members`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-Api-Key`
  - OAuth 2 (authorization code, authorization URL `https://erp.akeda.ru/oauth2/authorize`, token URL `https://erp.akeda.ru/oauth2/token`, scopes: `akeda:delegate`)

Отдаёт участников кабинета по логину без страниц. Без параметра status в выдачу попадают только действующие участники.

## Query parameters

- `status` 'active' | 'disabled' | 'all'

## Headers

- `X-Tenant` string, required

## Response `200`

Участники кабинета

- SettingsMemberPage
  - `count` integer, required: Число строк в results, а не общее число участников кабинета
  - `results` SettingsMember[], required
    - `id` string, uuid, required
    - `user_id` integer, required: Идентификатор человека в общем реестре платформы
    - `username` string, required
    - `full_name` string, required
    - `birth_date` string, date, nullable, required
    - `avatar_url` string, required
    - `role` string, uuid, required
    - `role_name` string, nullable, required
    - `company_scope` 'all' | 'selected', required
    - `companies` UUID[], required: Заполнен при company_scope selected
    - `is_active` boolean, required
    - `all_businesses` boolean, required: Роль действует во всех бизнесах кабинета, включая заведённые позже. У администратора всегда true
    - `businesses` SettingsMemberBusinessScope[], required: Бизнесы сотрудника; пуст при all_businesses
      - `business` string, uuid, required
      - `company` string, uuid
    - `access_until` string, date, nullable, required: Последний день доступа в этом кабинете: после конца этого дня в поясе кабинета вход закрыт. null — доступ бессрочный
    - `access_closed` boolean, required: Последний день доступа уже прошёл: участник числится активным, но войти не может и места тарифа не занимает
    - `is_guest` boolean, required: Гость-подрядчик (карточка «Команды» с affiliation guest): права роли сужены до задач, чата и файлов «только где участник», места тарифа не занимает

## Other responses

- `401`: Сессия, ключ или кабинет не подтверждены
- `403`: Текущая роль не имеет требуемого права

---

[API](https://skmtc.dev/akeda/apis/akeda-erp-client-api.md) · [All operations](https://skmtc.dev/akeda/apis/akeda-erp-client-api/llms.txt) · [OpenAPI document](https://skmtc.dev/akeda/apis/akeda-erp-client-api/revisions/3c60ded179f2?raw)
