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

POST kyc/checks/result


Описание

Отдаёт результаты запуска по runId. Метод опрашивается каждые 5–10 секунд, пока checksStatus не станет complete.


Формат запроса

  • HTTP метод: POST
  • URL: kyc/checks/result
  • Тип контента: application/json
  • Авторизация: обязательна (токен в поле token тела или в заголовке token)

Тело запроса (JSON)

ПолеТипОбязательныйОписание
tokenstringТокен доступа
runIdstringИдентификатор запуска из kyc/checks/run
{
  "token": "<permanent-token>",
  "runId": "523c8284-ad9e-11ef-9be1-b8ccad474166"
}

Пример запроса (cURL)

curl -X POST "https://api.neuro-vision.ru/v1/kyc/checks/result" \
  -H "Content-Type: application/json" \
  -d '{
    "token": "<permanent-token>",
    "runId": "523c8284-ad9e-11ef-9be1-b8ccad474166"
  }'

Ответ

ПолеТипОписание
checksStatusstringcomplete — все проверки запуска завершены, иначе pending
pendingnumberСколько проверок ещё не завершено
resultsarrayРезультаты; result равен null, пока проверка не завершена
Ответ (200 OK)
{
  "runId": "523c8284-ad9e-11ef-9be1-b8ccad474166",
  "checksStatus": "complete",
  "pending": 0,
  "results": [
    {
      "checker": "insolvencyStatus",
      "status": "success",
      "outcome": "performed",
      "notPerformedReason": null,
      "missingInputs": [],
      "spent": 1230,
      "result": {
        "passed": true,
        "score": null,
        "verified": null,
        "items": [],
        "totalCount": 0,
        "details": null,
        "error": null
      }
    },
    {
      "checker": "driverLicenseVerification",
      "status": "success",
      "outcome": "skipped",
      "notPerformedReason": "missingInput",
      "missingInputs": ["driverLicense"],
      "spent": null,
      "result": {
        "passed": null,
        "score": null,
        "verified": null,
        "items": [],
        "totalCount": 0,
        "details": null,
        "error": null
      }
    }
  ],
  "responseTime": "2026-07-28T10:03:00.000Z"
}

Как читать результат

Поле status — статус задачи проверки: idle, processing, success, failed, exception, expired, suspicious. Терминальные статусы — success, failed, exception.

Поле outcome читается раньше passed.

outcomeЗначение
performedИсточник опрошен, результат значимый
skippedПроверка не выполнялась из-за отсутствующих или непригодных данных; пустой результат означает «не проверяли», а не «чисто»
unavailableИсточник недоступен или ответил ошибкой, повторный запуск может сработать
nullПроверка ещё не завершена

notPerformedReason уточняет причину: missingInput, unusableInput, identityUnresolved, ageBelowDocumentAge, providerUnavailable, providerError, unknown. В missingInputs — каких данных не хватило.

Внутри result вердикт несёт passed: true — проверка пройдена (лицо не найдено в реестре риска либо валидация успешна), false — найдено совпадение или валидация не прошла, null — ошибка или пропуск. Записи лежат в items, их количество — в totalCount, дополнительные данные — в details, текст ошибки — в error.


Ошибки

КодТелоКогда
404run not foundЧужой или несуществующий runId
400runId is not a valid run identifierНекорректный идентификатор