POST kyc/checks/result
Описание
Отдаёт результаты запуска по runId. Метод опрашивается каждые 5–10 секунд, пока checksStatus не станет complete.
Формат запроса
- HTTP метод:
POST - URL:
kyc/checks/result - Тип контента:
application/json - Авторизация: обязательна (токен в поле
tokenтела или в заголовкеtoken)
Тело запроса (JSON)
| Поле | Тип | Обязательный | Описание |
|---|---|---|---|
| token | string | ✅ | Токен доступа |
| runId | string | ✅ | Идентификатор запуска из 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"
}' Ответ
| Поле | Тип | Описание |
|---|---|---|
| checksStatus | string | complete — все проверки запуска завершены, иначе pending |
| pending | number | Сколько проверок ещё не завершено |
| results | array | Результаты; 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.
Ошибки
| Код | Тело | Когда |
|---|---|---|
| 404 | run not found | Чужой или несуществующий runId |
| 400 | runId is not a valid run identifier | Некорректный идентификатор |