---
metadata:
  - name: generator
    content: Diplodoc Platform v5.52.0
alternate:
  - https://yandex.ru/dev/api360/doc/ru/authentication/get-2fa.md
  - href: ru/authentication/get-2fa.md
    type: text/markdown
    title: Markdown version
  - href: ../llms.txt
    type: text/markdown
    title: llms.txt
sourcePath: docs/dev/api360/concepts/gw/authentication/get-2fa.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/api360/doc/ru/llms.txt

# Посмотреть статус 2FA

Возвращает статус обязательной двухфакторной аутентификации в организации: выключена 2FA или включена и в каком режиме.

В ответе метод вернет параметр `enabled` со значением `true`, если на домене настроен `enforcement_mode=per_domain` и администратор подключил принудительную 2FA всем пользователям.


{% note info "" %}

Чтобы выполнить запрос, приложению требуется разрешение на управление обязательной двухфакторной аутентификацией. Убедитесь, что вы включили его при [настройке приложения]() на OAuth-сервере Яндекса.

{% endnote %}


## Запрос {#request}

##GET## `https://cloud-api.yandex.net/v1/directory/organizations/{org_id}/settings/2fa`

### Path-параметры {#path-parameters}

#|
|| **Имя параметра** | **Тип** | **Описание** ||
|| org_id **\*** | integer | Идентификатор организации. ||
|#

### Заголовки {#headers}

```json
Authorization: OAuth <токен>
```

### Пример {#example}

{% cut "Пример запроса" %}

```bash
curl --request GET \
--url https://cloud-api.yandex.net/v1/directory/organizations/123456/settings/2fa \
--header 'authorization: OAuth <токен>'
```

{% endcut %}

## Ответ {#response}

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

Результатом корректного запроса является ответ с кодом 200 и телом в формате JSON, где содержится объект с информацией о статусе 2FA.

`200 OK` — запрос выполнен успешно.

#|
|| **Имя параметра** | **Тип** | **Описание** ||
|| enabled&nbsp;**\***          | boolean             | Статус обязательной двухфакторной аутентификации:
* `true` — включена;
* `false` — выключена. ||
|| setup_grace_period_seconds         | integer             | Период (в секундах), в течение которого у пользователя в процессе авторизации есть возможность отложить настройку двухфакторной аутентификации, например `3600`. По истечении этого периода возможность отложить настройку отключается. Максимальный период — 6 месяцев (`16070400`). ||
|| enforcement_mode            | string              | Режим двухфакторной аутентификации:
* `per_domain` — сразу всем пользователям с аккаунтами на домене организации;
* `per_user` — только отдельным сотрудникам.
У кого именно из сотрудников настроен признак необходимости прохождения 2FA, если она включена в организации, можно узнать с помощью метода, описанного в разделе [Посмотреть статус персональной 2FA](). ||
|| enabled_at        | string<date-time>   | Дата и время, когда была включена двухфакторная аутентификация, например `2026-04-22T07:52:11+00:00`, если в предыдущем параметре выбран `per_domain`. ||
|| second_factor_type         | string             | Способ аутентификации:
* `phone` — через Яндекс ID;
* `totp` — через приложение для создания одноразовых паролей, например Яндекс Ключ. ||
|| preferred_phone_validation_method         | string             | Способ аутентификации через Яндекс ID, если в предыдущем параметре выбран `phone`:
* `default` — определяется автоматически;
* `call` — звонок по номеру телефона. ||
|#

{% cut "Пример ответа" %}


```json
{
  "enabled": true,
  "setup_grace_period_seconds": 3600,
  "enabled_at": "2026-04-22T07:52:11+00:00",
  "enforcement_mode": "per_domain",
  "second_factor_type": "phone",
  "preferred_phone_validation_method": "default"
}
```


{% endcut %}

### Неуспешный ответ {#unsuccessful}

Ошибки могут быть со следующими HTTP-статусами:

- `400 Bad Request` — параметры запроса не заданы или заданы неверно;
- `401 Unauthorized` — пользователь не авторизован;
- `403 Forbidden` — у пользователя или приложения нет прав на управление двухфакторной аутентификацией;
- `404 Not Found` — запрашиваемая организация не найдена;
- `422 Invalid Data` — некорректное тело запроса;
- `500 Internal Server Error` — ошибка произошла на стороне сервера (в этом случае попробуйте повторно отправить запрос через некоторое время).