KYC ПЛАТФОРМА

/authentications/{authenticationId}

Возвращает текущее состояние сессии по идентификатору, полученному при её создании.

Запрос

GET https://api.mts.ru/Id-Kyc-MobileIdAdapter-Prod/1.0/api/v1/mobile-id-adapter/authentications/{authenticationId}
Authorization: Bearer <access_token>

Ответ

Ответ содержит authenticationId, externalId, status, время создания и обновления, сроки действия, оставшиеся попытки SMS-кода, subId и errorCode (неприменимые значения возвращаются как null).

{
  "authenticationId": "0195fa8e-61e5-7c40-b4af-f577674fd349",
  "externalId": "login-session-123",
  "status": "success",
  "createdAt": "2026-09-11T13:15:00Z",
  "updatedAt": "2026-09-11T13:15:48Z",
  "expiresAt": "2026-09-11T13:17:20Z",
  "smsCodeExpiresAt": null,
  "remainingAttempts": null,
  "subId": "873d1a98-23ef-42be-a14c-f577674fd349",
  "errorCode": null
}

Статусы сессии

Возможные статусы:

  • pending — ожидание подтверждения пользователя
  • smsCodeRequired — требуется ввод SMS-кода
  • smsCodeSubmitted — SMS-код отправлен на проверку
  • success — аутентификация успешна
  • failed — аутентификация не удалась
  • expired — сессия истекла

Опросите состояние не чаще одного раза в две секунды и прекратите polling на конечном статусе.

Важно

Считайте пользователя аутентифицированным только при status: "success" и непустом subId. Значение 202 Accepted при создании или отправке кода само по себе не является итогом аутентификации.