Technology events
Technology events provide information about the progress and results of specific checks within a session. For each technology, technology.start events are generated at the start of the verification and technology.end events at the end of the verification. The events contain technology-specific results and, if unsuccessful, detailed information about the cause of the error.
Failure Reason structure
| Field |
Type |
Description |
type |
string |
Error type |
detail |
string |
Detailed description of the error (optional) |
Liveness Technology events
Liveness Head Position
Result fields description
| Field |
Type |
Description |
result |
boolean |
Overall verification result |
eye_closed |
boolean |
Close eyes sign |
prediction |
string |
Assessment of the probability of liveness (0 to 1) |
face_center |
boolean |
Face center position sign |
face_direction |
string |
Face direction |
failure_reason |
object | null |
Failure reason (null in case of success) |
technology.start
{
"id": "8c44f37b-6040-40ed-b391-682a3b29dc2b",
"event": "technology.start",
"session_id": "70f5e424-07a9-4393-ba31-7f3de8681a72",
"created": 1734597343,
"success": true,
"flow_name": "Liveness Head Position Flow",
"metadata": {},
"data": {
"technology_code": "LDHP",
"technology_name": "Liveness Head Position"
}
}
technology.end
{
"id": "35bef608-a327-4b46-a4e0-cf1a8c6e0703",
"event": "technology.end",
"session_id": "70f5e424-07a9-4393-ba31-7f3de8681a72",
"created": 1734597388,
"success": true,
"flow_name": "Liveness Head Position Flow",
"metadata": {},
"data": {
"liveness_result": {
"result": true,
"eye_closed": false,
"prediction": "0.9980",
"face_center": true,
"face_direction": "forward",
"failure_reason": null
}
}
}
Liveness Distance
Result fields description
| Field |
Type |
Description |
result |
boolean |
Overall verification result |
eye_closed |
boolean |
Close eyes sign |
prediction |
string |
Assessment of the probability of liveness (0 to 1) |
face_center |
boolean |
Face center position sign |
face_direction |
string |
Face direction |
failure_reason |
object | null |
Failure reason (null in case of success) |
technology.start
{
"id": "f9dd4030-1414-443b-9a26-62d952cbec7a",
"event": "technology.start",
"session_id": "6882098c-7b0c-4cc2-b043-d0c290b40198",
"created": 1734599979,
"success": true,
"flow_name": "Liveness Distance Flow",
"metadata": {},
"data": {
"technology_code": "LDD",
"technology_name": "Liveness Face Distance"
}
}
technology.end
{
"id": "0069285b-b28f-4105-b718-42dfc938efd8",
"event": "technology.end",
"session_id": "6882098c-7b0c-4cc2-b043-d0c290b40198",
"created": 1734599993,
"success": true,
"flow_name": "Liveness Distance Flow",
"metadata": {},
"data": {
"liveness_result": {
"result": true,
"eye_closed": true,
"prediction": "0.9980",
"face_center": true,
"face_direction": "forward",
"failure_reason": null
}
}
}
Liveness Pro Max
Result fields description
| Field |
Type |
Description |
result |
boolean |
Overall verification result |
eye_closed |
boolean |
Close eyes sign |
prediction |
string |
Assessment of the probability of liveness (0 to 1) |
face_center |
boolean |
Face center position sign |
face_direction |
string |
Face direction |
failure_reason |
object | null |
Failure reason (null in case of success) |
technology.start
{
"id": "e9afa559-09de-4d7b-89a0-dacd413febdc",
"event": "technology.start",
"session_id": "84f84b3d-4f8b-403d-a95c-fe214697f4cb",
"created": 1734599979,
"success": true,
"flow_name": "Liveness Pro Max Flow",
"metadata": {},
"data": {
"technology_code": "LDPM",
"technology_name": "Liveness Pro Max"
}
}
technology.end
{
"id": "e9afa559-09de-4d7b-89a0-dacd413febdc",
"event": "technology.end",
"session_id": "84f84b3d-4f8b-403d-a95c-fe214697f4cb",
"created": 1734599993,
"success": true,
"flow_name": "Liveness Pro Max Flow",
"metadata": {},
"data": {
"liveness_result": {
"result": true,
"eye_closed": true,
"prediction": "0.9980",
"face_center": true,
"face_direction": "forward",
"failure_reason": null
}
}
}
Liveness Short
Result fields description
| Field |
Type |
Description |
result |
boolean |
Overall verification result |
eye_closed |
boolean |
Close eyes sign |
prediction |
string |
Assessment of the probability of liveness (0 to 1) |
face_center |
boolean |
Face center position sign |
face_direction |
string |
Face direction |
failure_reason |
object | null |
Failure reason (null in case of success) |
technology.start
{
"id": "e9afa559-09de-4d7b-89a0-dacd413febdc",
"event": "technology.start",
"session_id": "84f84b3d-4f8b-403d-a95c-fe214697f4cb",
"created": 1734599979,
"success": true,
"flow_name": "Liveness Short(Fast) Flow",
"metadata": {},
"data": {
"technology_code": "LDSH",
"technology_name": "Liveness Short"
}
}
technology.end
{
"id": "e9afa559-09de-4d7b-89a0-dacd413febdc",
"event": "technology.end",
"session_id": "84f84b3d-4f8b-403d-a95c-fe214697f4cb",
"created": 1734599993,
"success": true,
"flow_name": "Liveness Short(Fast) Flow",
"metadata": {},
"data": {
"liveness_result": {
"result": true,
"eye_closed": true,
"prediction": "0.9980",
"face_center": true,
"face_direction": "forward",
"failure_reason": null
}
}
}
Face2Face Technology events
Face2Face
Result fields description
| Field |
Type |
Description |
result |
boolean |
Overall verification result |
prediction |
string |
Comparison score (0 to 1) |
prediction_percent |
string |
Comparison percent (0 to 100) |
failure_reason |
object | null |
Failure reason (null in case of success) |
technology.start
{
"id": "e9afa559-09de-4d7b-89a0-dacd413febdc",
"event": "technology.start",
"session_id": "84f84b3d-4f8b-403d-a95c-fe214697f4cb",
"created": 1734599979,
"success": true,
"flow_name": "Face2Face Flow",
"metadata": {},
"data": {
"technology_code": "F2F",
"technology_name": "Face2Face"
}
}
technology.end
{
"id": "e9afa559-09de-4d7b-89a0-dacd413febdc",
"event": "technology.end",
"session_id": "84f84b3d-4f8b-403d-a95c-fe214697f4cb",
"created": 1734599993,
"success": true,
"flow_name": "Face2Face Flow",
"metadata": {},
"data": {
"face2face_result": {
"result": true,
"prediction": "0.9980",
"prediction_percent": "99",
"failure_reason": null
}
}
}
E-Document Technology events
E-Document
Result fields description
| Field |
Type |
Description |
result |
boolean |
Overall verification result |
result_json |
object | null |
Document data |
document_type |
string |
Document type |
phone |
string |
Subject phone number |
failure_reason |
object | null |
Failure reason (null in case of success) |
technology.start
{
"id": "e9afa559-09de-4d7b-89a0-dacd413febdc",
"event": "technology.start",
"session_id": "84f84b3d-4f8b-403d-a95c-fe214697f4cb",
"created": 1734599979,
"success": true,
"flow_name": "E-Document Flow",
"metadata": {},
"data": {
"technology_code": "ED",
"technology_name": "EDocument"
}
}
technology.end
{
"id": "e9afa559-09de-4d7b-89a0-dacd413febdc",
"event": "technology.end",
"session_id": "84f84b3d-4f8b-403d-a95c-fe214697f4cb",
"created": 1734599993,
"success": true,
"flow_name": "E-Document Flow",
"metadata": {},
"data": {
"edocument_result": {
"result": true,
"result_json": {
"data": {
"common": {
"docOwner": {
"firstName": "ИМЯ",
"lastName": "ФАМИЛИЯ",
"engFirstName": "NAME",
"middleName": "",
"engSurname": "SURNAME",
"iin": "010101010101"
},
"docIssuedDate": 1523383200000,
"docIssuer": {
"nameRu": "МИНИСТЕРСТВО ВНУТРЕННИХ ДЕЛ РК",
"nameKk": "ҚР ІШКІ ІСТЕР МИНИСТРЛІГІ",
"nameEn": "МИНИСТЕРСТВО ВНУТРЕННИХ ДЕЛ РК"
},
"docNumber": "0101010101",
"docType": {
"nameRu": "Удостоверение личности",
"code": "IdentityCard",
"nameKk": "Жеке куәлік",
"nameEn": "Identity card"
},
"docExpirationDate": 1838916000000,
"docUri": "IdentityCard:0101010101"
},
"domain": {
"birthPlace": {
"nameRu": "ГОРОД",
"nameKk": "ГОРОД",
"nameEn": "CITY"
},
"docIssuedDate": 1523383200000,
"nationality": {
"nameRu": "ҚАЗАҚ",
"nameKk": "ҚАЗАҚ",
"nameEn": "ҚАЗАҚ"
},
"docNumber": "0101010101",
"birthDate": 946684800000,
"docExpirationDate": 1838916000000,
"docPhoto": "base64",
"docBarcode": "base64"
}
}
},
"document_type": "IdentityCard",
"phone": "77771234567",
"failure_reason": null
}
}
}
Document Recognition Technology events
Document Recognition
Result fields description
| Field |
Type |
Description |
result |
boolean |
Overall verification result |
first_name |
string |
First name |
last_name |
string |
Last name |
patronymic |
string |
Patronymic |
authority |
string |
Issuing authority |
date_of_birth |
string |
Date of birth |
date_of_expiry |
string |
Document date of expiration |
date_of_issue |
string |
Document date of issue |
document_number |
string |
Document number |
personal_number |
string |
IIN (ID Number) |
raw_data |
object | null |
Unformatted document data |
failure_reason |
object | null |
Failure reason (null in case of success) |
technology.start
{
"id": "e9afa559-09de-4d7b-89a0-dacd413febdc",
"event": "technology.start",
"session_id": "84f84b3d-4f8b-403d-a95c-fe214697f4cb",
"created": 1734599979,
"success": true,
"flow_name": "Document Recognition Flow",
"metadata": {},
"data": {
"technology_code": "DR",
"technology_name": "Document Recognition"
}
}
technology.end
{
"id": "e9afa559-09de-4d7b-89a0-dacd413febdc",
"event": "technology.end",
"session_id": "84f84b3d-4f8b-403d-a95c-fe214697f4cb",
"created": 1734599993,
"success": true,
"flow_name": "Document Recognition Flow",
"metadata": {},
"data": {
"document_recognition_result": {
"first_name": "ИМЯ",
"last_name": "ФАМИЛИЯ",
"patronymic": "ОТЧЕСТВО",
"result": true,
"authority": "МИНИСТЕРСТВО ВНУТРЕННИХ ДЕЛ РК",
"date_of_birth": "946684800000",
"date_of_expiry": "1838916000000",
"date_of_issue": "1523383200000",
"document_number": "0101010101",
"personal_number": "010101010101",
"raw_data": null,
"failure_reason": null
}
}
}
Address Technology events
Address
Result fields description
| Field |
Type |
Description |
result |
boolean |
Overall verification result |
address |
object | null |
Address |
status |
string |
Request status |
iin |
string |
IIN (ID Number) |
failure_reason |
object | null |
Failure reason (null in case of success) |
technology.start
{
"id": "e9afa559-09de-4d7b-89a0-dacd413febdc",
"event": "technology.start",
"session_id": "84f84b3d-4f8b-403d-a95c-fe214697f4cb",
"created": 1734599979,
"success": true,
"flow_name": "Address Flow",
"metadata": {},
"data": {
"technology_code": "ADR / ADR2",
"technology_name": "Address SMS / no SMS"
}
}
technology.end
{
"id": "e9afa559-09de-4d7b-89a0-dacd413febdc",
"event": "technology.end",
"session_id": "84f84b3d-4f8b-403d-a95c-fe214697f4cb",
"created": 1734599993,
"success": true,
"flow_name": "Address Flow",
"metadata": {},
"data": {
"address_result": {
"iin": "010101010101",
"address": {
"country": {
"code": "398",
"nameRu": "КАЗАХСТАН",
"nameKz": "ҚАЗАҚСТАН",
"changeDate": "2008-03-01T13:21:44+06:00"
},
"region": {
"code": "1910267",
"nameRu": "ЖЕТЫСУСКИЙ",
"nameKz": "ЖЕТІСУ",
"changeDate": "2008-03-01T13:21:45+06:00"
},
"city": "ҚАЛА IШIНДЕГI АУДАНЫ Жетысуский",
"street": "УЛИЦА Ломоносова",
"building": "13",
"flat": "1",
"foreign_data": {
"districtName": "РЕСПУБЛИКАЛЫҚ МАҢЫЗЫ БАР ҚАЛАСЫ Алматы"
}
},
"status": "VALID",
"failure_reason": null,
"result": true
}
}
}
GBDFL
Result fields description
| Field |
Type |
Description |
result |
boolean |
Overall verification result |
result_json |
object | null |
Address |
status |
string |
Request status |
iin |
string |
IIN (ID Number) |
failure_reason |
object | null |
Failure reason (null in case of success) |
technology.start
{
"id": "e9afa559-09de-4d7b-89a0-dacd413febdc",
"event": "technology.start",
"session_id": "84f84b3d-4f8b-403d-a95c-fe214697f4cb",
"created": 1734599979,
"success": true,
"flow_name": "GBDFL Flow",
"metadata": {},
"data": {
"technology_code": "GBDFL",
"technology_name": "GBDFL Technology"
}
}
technology.end
{
"id": "e9afa559-09de-4d7b-89a0-dacd413febdc",
"event": "technology.end",
"session_id": "84f84b3d-4f8b-403d-a95c-fe214697f4cb",
"created": 1734599993,
"success": true,
"flow_name": "GBDFL Flow",
"metadata": {},
"data": {
"gbdfl_result": {
"iin": "010101010101",
"result": true,
"result_json": {
"gbdfl_response": {
"iin": "010101010101",
"surname": "ТЕСТОВ",
"name": "ТЕСТ",
"patronymic": "ТЕСТОВИЧ",
"birth_date": "2000-01-01",
"gender": "Мужской",
"nationality": "КАЗАХ",
"citizenship": "КАЗАХСТАН",
"life_status": "Нормальный",
"birth_place": {
"country": "КАЗАХСТАН",
"region": "АЛМАТЫ",
"district": "АЛМАТИНСКАЯ ОБЛАСТЬ",
"city": "АЛМАТЫ"
},
"documents": [
{
"type": "УДОСТОВЕРЕНИЕ РК",
"number": "N00000001",
"issue_date": "2020-01-01",
"expiry_date": "2030-01-01",
"issuer": "МВД РК",
"status": "ДОКУМЕНТ ДЕЙСТВИТЕЛЕН"
}
],
"registration_address": {
"country": "КАЗАХСТАН",
"region": "АЛМАТЫ",
"district": "АЛМАТИНСКАЯ ОБЛАСТЬ",
"city": "АЛМАТЫ",
"street": "ТЕСТОВАЯ",
"building": "1",
"flat": "1",
"begin_date": "2020-01-01"
}
}
},
"status": "VALID",
"failure_reason": null
}
}
}
NPCK Technologies events
Face2Face NPCK
Result fields description
| Field |
Type |
Description |
result |
boolean |
Overall verification result |
prediction |
string |
Comparison score (0 to 1) |
prediction_percent |
string |
Comparison percent (0 to 100) |
failure_reason |
object | null |
Failure reason (null in case of success) |
technology.start
{
"id": "e9afa559-09de-4d7b-89a0-dacd413febdc",
"event": "technology.start",
"session_id": "84f84b3d-4f8b-403d-a95c-fe214697f4cb",
"created": 1734599979,
"success": true,
"flow_name": "Face2Face NPCK Flow",
"metadata": {},
"data": {
"technology_code": "F2F_NPCK",
"technology_name": "F2F NPCK"
}
}
technology.end
{
"id": "e9afa559-09de-4d7b-89a0-dacd413febdc",
"event": "technology.end",
"session_id": "84f84b3d-4f8b-403d-a95c-fe214697f4cb",
"created": 1734599993,
"success": true,
"flow_name": "Face2Face NPCK Flow",
"metadata": {},
"data": {
"f2f_npck_result": {
"prediction": "0.9980",
"prediction_percent": "99",
"result": true,
"failure_reason": null
}
}
}
GBDFL NPCK
Result fields description
| Field |
Type |
Description |
result |
boolean |
Overall verification result |
result_json |
object | null |
Address |
failure_reason |
object | null |
Failure reason (null in case of success) |
technology.start
{
"id": "e9afa559-09de-4d7b-89a0-dacd413febdc",
"event": "technology.start",
"session_id": "84f84b3d-4f8b-403d-a95c-fe214697f4cb",
"created": 1734599979,
"success": true,
"flow_name": "GBDFL NPCK Flow",
"metadata": {},
"data": {
"technology_code": "GBDFLN",
"technology_name": "GBD FL NPCK"
}
}
technology.end
{
"id": "e9afa559-09de-4d7b-89a0-dacd413febdc",
"event": "technology.end",
"session_id": "84f84b3d-4f8b-403d-a95c-fe214697f4cb",
"created": 1734599993,
"success": true,
"flow_name": "GBDFL NPCK Flow",
"metadata": {},
"data": {
"gbdfl_npck_result": {
"result": true,
"result_json": {
"person": {
"name": "ИМЯ",
"patronymic": "ОТЧЕСТВО",
"surname": "ФАМИЛИЯ",
"iin": "020202012345",
"mobilephone": "",
"birthDate": "2002-02-02",
"birthPlace": {
"country": {
"nameRu": "КАЗАХСТАН",
"code": "2",
"nameKz": "ҚАЗАҚСТАН",
"changeDate": "2022-02-02 00:00:00"
},
"city": "-",
"district": {
"nameRu": "ГОРОД",
"code": "2",
"nameKz": "ГОРОД",
"changeDate": "2022-02-02 00:00:00"
},
"region": {
"nameRu": "РАЙОН",
"code": "2",
"nameKz": "РАЙОН",
"changeDate": "2022-02-02 00:00:00"
}
},
"regAddress": {
"country": {
"nameRu": "КАЗАХСТАН",
"code": "2",
"nameKz": "ҚАЗАҚСТАН",
"changeDate": "2022-02-02 00:00:00"
},
"beginDate": "2022-02-02",
"street": "УЛИЦА",
"flat": "2",
"district": {
"nameRu": "ГОРОД",
"code": "2",
"nameKz": "ГОРОД",
"changeDate": "2022-02-02 00:00:00"
},
"region": {
"nameRu": "РАЙОН",
"code": "2",
"nameKz": "РАЙОН",
"changeDate": "2022-02-02 00:00:00"
},
"building": "2"
},
"documents": {
"document": [
{
"number": "123456789",
"beginDate": "2022-02-02",
"patronymic": "ОТЧЕСТВО",
"endDate": "2022-02-02",
"surname": "ФАМИЛИЯ",
"name": "ИМЯ",
"type": {
"nameRu": "УДОСТОВЕРЕНИЕ РК",
"code": "",
"nameKz": "ҚР ЖЕКЕ КУӘЛІГІ",
"changeDate": "2022-02-02 00:00:00"
},
"birthDate": "2002-02-02",
"issueOrganization": {
"nameRu": "ОРГАНИЗАЦИЯ ВЫДАЧИ",
"code": "0",
"nameKz": "",
"changeDate": "2002-02-02 00:00:00"
},
"status": {
"nameRu": "СТАТУС ДОКУМЕНТА",
"code": "0",
"nameKz": "",
"changeDate": "2002-02-02 00:00:00"
}
}
]
},
"citizenship": {
"nameRu": "ГРАЖДАНСТВО",
"code": "0",
"nameKz": "",
"changeDate": "2008-02-02 00:00:00"
},
"lifeStatus": {
"nameRu": "Нормальный",
"code": "0",
"nameKz": "",
"changeDate": "2002-02-02 00:00:00"
},
"gender": {
"nameRu": "ПОЛ",
"code": "0",
"nameKz": "",
"changeDate": "2022-02-02 00:00:00"
},
"nationality": {
"nameRu": "НАЦИОНАЛЬНОСТЬ",
"code": "0",
"nameKz": "",
"changeDate": "2002-02-02 00:00:00"
}
}
},
"failure_reason": null
}
}
}
KZ-INFO Technology events
KZ-INFO
Result fields description
| Field |
Type |
Description |
iin |
boolean |
IIN (ID Number) |
exec_proc_info_status |
string |
Request status |
exec_proc_info |
object | null |
AIS EA Result |
failure_reason |
object | null |
Failure reason (null in case of success) |
technology.start
{
"id": "e9afa559-09de-4d7b-89a0-dacd413febdc",
"event": "technology.start",
"session_id": "84f84b3d-4f8b-403d-a95c-fe214697f4cb",
"created": 1734599979,
"success": true,
"flow_name": "KZ Info Flow",
"metadata": {},
"data": {
"technology_code": "KZ_INFO",
"technology_name": "Kz Citizen Info Technology"
}
}
technology.end
{
"id": "e9afa559-09de-4d7b-89a0-dacd413febdc",
"event": "technology.end",
"session_id": "84f84b3d-4f8b-403d-a95c-fe214697f4cb",
"created": 1734599993,
"success": true,
"flow_name": "KZ Info Flow",
"metadata": {},
"data": {
"gbdfl_npck_result": {
"result": true,
"result_json": [
{
"exec_proc": "12345678",
"exec_proc_num": "1164/20-75-3430",
"ip_start_date": "2020-06-11T00:00:00.000+05:00",
"il_date": "2020-05-22T00:00:00.000+05:00",
"debtor_iin": "970128301134",
"debtor_name": "NAME",
"debtor_secondname": "SECONDNAME",
"il_organ_ru": "Notary Chamber of Almaty",
"il_organ_kz": "Notary Chamber of Almaty",
"category_ru": "Debt collection",
"category_kz": "Debt collection",
"recovery_amount": "100000.000",
"officer_surname": "OFFICER_SURNAME",
"officer_name": "OFFICER_NAME",
"officer_secondname": [
"OFFICER_SURNAME",
"Private bailiffs of Almaty",
"Алматы қ."
],
"disa_name_ru": "Private bailiffs of Almaty",
"disa_department_name_ru": "Private bailiffs of Almaty",
"recoverer_type_ru": "Individual",
"recoverer_type_kz": "Individual",
"recoverer_iin": "010101010101",
"recoverer_surname": "RECOVERER_SURNAME",
"recoverer_name": "RECOVERER_NAME",
"recoverer_secondname": "RECOVERER_SECONDNAME",
"recoverer_bin": "010101010101",
"recoverer_title": "RECOVERER_TITLE"
}
],
"failure_reason": null
}
}
}