KYC ПЛАТФОРМА

Получить результат

Назначение

Метод results возвращает результаты ранее созданных batch-запросов по одному или нескольким verificationExternalId.

Итоговая структура ответа совпадает с форматом, который может приходить в callback.

Эндпоинт

Боевой контур:

POST https://api.mts.ru/ID-KYC-Verification-API-Prod/2.0/api/v2/verifications/results

Prodlike:

POST https://api.mts.ru/ID-KYC-Verification-API-Prodlike/2.0/api/v2/verifications/results

Авторизация

Authorization: Bearer <JWT>

Тело запроса

{
  "verificationExternalIds": [
    "122222222000909000310900000500"
  ]
}
Атрибут Тип Описание
verificationExternalIds array[string] Список внешних идентификаторов запросов на верификацию

Пример ответа

{
  "items": [
    {
      "id": "019bb161-2a10-421b-bc58-904c564aea38",
      "verificationExternalId": "122222222000909000310900000500",
      "applicantExternalId": "ivanov1989",
      "createdAt": "2026-01-12T08:44:53.651159Z",
      "status": "success",
      "esiaAccountVerification": {
        "status": "success",
        "esiaId": "99584993",
        "hasBiometrics": true,
        "biometryType": "Confirmed",
        "accountStatus": "trusted",
        "messageId": "f70eeead-ef92-11f0-ab0b-ea152b4e93ac"
      },
      "inn": {
        "status": "success",
        "value": "392920209"
      },
      "passportVerification": {
        "status": "success",
        "queryId": "1f0ef83b-033a-6a31-a637-05b89cea607a",
        "state": "valid"
      },
      "generalFraudScoring": {
        "status": "success",
        "value": "0.05570476862799033"
      },
      "ecomFraudScoring": {
        "status": "success",
        "value": "0.4074598249592958"
      },
      "lifetimeBinScoring": {
        "status": "success",
        "value": 5
      },
      "lifetimeOwnerScoring": {
        "status": "success"
      },
      "lifetimeDeviceScoring": {
        "status": "success"
      },
      "activeNumberScoring": {
        "status": "success",
        "value": 1
      },
      "riskScoring": {
        "status": "success",
        "value": "0.03225891569952845"
      }
    }
  ]
}

Общие поля ответа

Атрибут Тип Описание
items array Массив результатов
id string Внутренний идентификатор запроса на верификацию
verificationExternalId string Внешний идентификатор запроса
applicantExternalId string Внешний идентификатор заявителя
createdAt string Время создания/ответа
status string Общий статус: success, fail, inProgress

Результаты проверок

ЕСИА (esiaAccountVerification)

Атрибут Описание
status Статус получения данных
esiaId Идентификатор учетной записи в ЕСИА
hasBiometrics Наличие биометрического профиля: true, false или null
biometryType Качество биометрии: Confirmed, Standard, Simplified
accountStatus Статус учетной записи: unverified, verified, trusted, readytoconfirm
messageId Идентификатор запроса в СМЭВ3

ИНН (inn)

Атрибут Описание
status success – данные получены, fail – нет ответа от источника
value Найденное значение ИНН

Паспорт РФ (passportVerification)

Атрибут Описание
status success – данные получены, fail – нет ответа от источника
state valid, notValid, noDataFound
queryId Идентификатор запроса в СМЭВ4

Скоринги

Блок Значение
generalFraudScoring.value Антифрод-скоринг с широким таргетом, значение от 0 до 1
ecomFraudScoring.value Антифрод-скоринг для e-commerce, значение от 0 до 1
riskScoring.value Вероятность выхода заемщика в просрочку 90+ дней на горизонте 12 месяцев, значение от 0 до 1
lifetimeBinScoring.value Срок жизни SIM в бине: 0 – [0, 30), 1 – [30, 61), 2 – [61, 182), 3 – [182, 365), 4 – [365, 1095), 5 – [1095, +inf)
activeNumberScoring.value Активность номера за последний месяц: 1 – есть активность, 0 – нет активности
lifetimeOwnerScoring.status Статус проверки срока с момента смены владельца номера; value не возвращается
lifetimeDeviceScoring.status Статус проверки срока использования SIM в устройстве; value не возвращается

Callback

Если в batch-запросе указан fullDataCallbackEnabled: true и задан callbackUrl, сервис отправляет результат на callback. Тело callback соответствует структуре ответа метода POST /verifications/results.

Что смотреть дальше