Tenant API (KYC)
Applicants
An applicant is a user who is going through or has completed verification. The Tenant API exposes the applicant list, individual applicant details, verification and AML screening results, and the document list. Each endpoint requires the matching scope on the API key.
List applicants
Returns a paginated list of applicants with filters for status, creation date, and external identifier. Required scope: applicants:read.
GET
ApiKeyAuthheader
Authorization<token>HMAC-SHA256 Credential=<key_id>, Signature=<hex_signature>. SignedHeaders=x-timestamp is optional. Requires X-Timestamp header.
limit?integerLimit (1-100, default 50)
offset?integerOffset (default 0)
status?stringFilter by verification status
Value in
"pending""verified""rejected""review"X-Timestamp*stringUnix timestamp (seconds, max 5 min drift)
Applicants list
application/json- response
data?array<>pagination?success?booleancurl -X GET 'https://example.com/tenant/v1/kyc/applicants' \ -H 'X-Timestamp: string'Example Response
{ "pagination": { "has_more": true, "limit": 0, "next_cursor": "string", "offset": 0, "total": 0 }, "success": true, "data": [ { "address": "string", "aml_decision": "string", "aml_risk_score": 0, "avatar_photo_url": "string", "avatar_url": "string", "client_liveness_score": 0, "created_at": "string", "current_review_decision": { "client_message": "string", "created_at": "string", "decision": "string", "id": "string", "reason_codes": [ "string" ], "scope": "string", "session_id": "string", "step_id": "string" }, "date_of_birth": "string", "details": { "address": { "city": "string", "country": "string", "full_text": "string", "localized": { "property1": { "property1": "string", "property2": "string" }, "property2": { "property1": "string", "property2": "string" } }, "postal_code": "string", "region": "string", "street": "string" }, "barcode": { "fields": { "property1": "string", "property2": "string" }, "raw": "string", "type": "string" }, "document": { "booklet_number": "string", "class": "string", "issuing_authority": "string", "issuing_place": "string", "issuing_state_code": "string", "mrz_type": "string", "series": "string" }, "localized": { "property1": { "property1": "string", "property2": "string" }, "property2": { "property1": "string", "property2": "string" } }, "mrz": { "document_code": "string", "fields": { "property1": "string", "property2": "string" }, "issuing_state": "string", "raw": "string" }, "personal": { "additional_fields": { "property1": "string", "property2": "string" }, "nationality_name": "string", "personal_number": "string", "profession": "string", "tax_number": "string" }, "provider": { "duration_ms": 0, "evidence_reuse": { "execution_id": "string", "reason": "string", "recovery_audit_id": "string", "source_attempt_number": 0, "source_execution_id": "string", "source_verification_id": "string" }, "name": "string", "raw": { "property1": null, "property2": null }, "raw_response_key": "string", "received_at": "string", "request_id": "string", "version": "string" } }, "doc_liveness_score": 0, "document_back_key": "string", "document_back_url": "string", "document_front_key": "string", "document_front_url": "string", "document_number": "string", "document_photo_key": "string", "document_photo_url": "string", "document_type": "string", "email": "string", "enrichment": { "scope": "string", "summary": { "bankruptcy_confirmed": true, "call_statuses": { "property1": "string", "property2": "string" }, "completed_at": "string", "hard_block_reason": "string", "match_count": 0, "merged_decision": "string", "merged_risk_score": 0, "observed_at": "string", "passport_invalid": true, "status": "string" } }, "enrichment_errors": [ "string" ], "expiry_date": "string", "expiry_status": "string", "external_id": "string", "face_match_score": 0, "first_name": "string", "full_name": "string", "full_name_latin": "string", "full_name_native": "string", "full_name_original": "string", "id": "string", "issuing_country": "string", "issuing_state_code": "string", "last_name": "string", "last_session_id": "string", "last_verified_at": "string", "latest_flow_name": "string", "liveness_mode": "string", "liveness_score": 0, "localized": { "property1": { "property1": "string", "property2": "string" }, "property2": { "property1": "string", "property2": "string" } }, "middle_name": "string", "name_source": { "property1": null, "property2": null }, "nationality": "string", "phone": "string", "photo_url_expires_at": "string", "portrait_photo_key": "string", "portrait_photo_url": "string", "risk_score": 0, "risk_signals": { "property1": null, "property2": null }, "selfie_photo_key": "string", "selfie_photo_url": "string", "session_summary": { "approved": 0, "in_progress": 0, "rejected": 0, "review": 0, "total": 0 }, "updated_at": "string", "verification_score": 0, "verification_status": "pending" } ]}Get applicant by ID
Returns the full applicant record by internal identifier (UUID). Required scope: applicants:read.
GET
ApiKeyAuthheader
Authorization<token>HMAC-SHA256 Credential=<key_id>, Signature=<hex_signature>. SignedHeaders=x-timestamp is optional. Requires X-Timestamp header.
applicant_id*stringApplicant UUID
detailed?booleanInclude document recognition, personal info and sessions (default false)
X-Timestamp*stringUnix timestamp (seconds, max 5 min drift)
Applicant profile; detailed fields are included only with detailed=true
application/json- response
data?success?booleancurl -X GET 'https://example.com/tenant/v1/kyc/applicants/string' \ -H 'X-Timestamp: string'Example Response
{ "success": true, "data": { "address": "string", "aml_decision": "string", "aml_risk_score": 0, "avatar_photo_url": "string", "avatar_url": "string", "client_liveness_score": 0, "created_at": "string", "current_review_decision": { "client_message": "string", "created_at": "string", "decision": "string", "id": "string", "reason_codes": [ "string" ], "scope": "string", "session_id": "string", "step_id": "string" }, "date_of_birth": "string", "details": { "address": { "city": "string", "country": "string", "full_text": "string", "localized": { "property1": { "property1": "string", "property2": "string" }, "property2": { "property1": "string", "property2": "string" } }, "postal_code": "string", "region": "string", "street": "string" }, "barcode": { "fields": { "property1": "string", "property2": "string" }, "raw": "string", "type": "string" }, "document": { "booklet_number": "string", "class": "string", "issuing_authority": "string", "issuing_place": "string", "issuing_state_code": "string", "mrz_type": "string", "series": "string" }, "localized": { "property1": { "property1": "string", "property2": "string" }, "property2": { "property1": "string", "property2": "string" } }, "mrz": { "document_code": "string", "fields": { "property1": "string", "property2": "string" }, "issuing_state": "string", "raw": "string" }, "personal": { "additional_fields": { "property1": "string", "property2": "string" }, "nationality_name": "string", "personal_number": "string", "profession": "string", "tax_number": "string" }, "provider": { "duration_ms": 0, "evidence_reuse": { "execution_id": "string", "reason": "string", "recovery_audit_id": "string", "source_attempt_number": 0, "source_execution_id": "string", "source_verification_id": "string" }, "name": "string", "raw": { "property1": null, "property2": null }, "raw_response_key": "string", "received_at": "string", "request_id": "string", "version": "string" } }, "doc_liveness_score": 0, "document_back_key": "string", "document_back_url": "string", "document_details": { "additional_fields": { "property1": "string", "property2": "string" }, "address": "string", "authority_code": "string", "barcode": { "property1": "string", "property2": "string" }, "booklet_number": "string", "date_of_birth": "string", "date_of_expiry": "string", "date_of_issue": "string", "document_class_code": "string", "document_number": "string", "document_series": "string", "document_type": "string", "first_name": "string", "full_name": "string", "full_name_latin": "string", "full_name_native": "string", "full_name_original": "string", "gender": "string", "issuing_authority_name": "string", "issuing_country": "string", "issuing_state_code": "string", "last_name": "string", "localized_fields": { "property1": "string", "property2": "string" }, "middle_name": "string", "mrz_code": "string", "mrz_data": { "property1": "string", "property2": "string" }, "mrz_type": "string", "nationality": "string", "nationality_name": "string", "ocr": { "additional": { "property1": "string", "property2": "string" }, "address": "string", "barcode": { "property1": "string", "property2": "string" }, "booklet_number": "string", "date_of_birth": "string", "document_class": "string", "document_name": "string", "document_number": "string", "document_series": "string", "document_type": "string", "expiry_date": "string", "field_issues": { "property1": "string", "property2": "string" }, "first_name": "string", "full_name": "string", "full_name_latin": "string", "gender": "string", "issue_date": "string", "issuing_authority": "string", "issuing_authority_name": "string", "issuing_country": "string", "issuing_place": "string", "issuing_state_code": "string", "last_name": "string", "localized": { "property1": { "property1": "string", "property2": "string" }, "property2": { "property1": "string", "property2": "string" } }, "middle_name": "string", "mrz_code": "string", "mrz_data": { "property1": "string", "property2": "string" }, "mrz_type": "string", "nationality": "string", "nationality_name": "string", "native_full_name": "string", "personal_number": "string", "place_of_birth": "string", "portrait": "string", "portrait_position": { "x1": 0, "x2": 0, "y1": 0, "y2": 0 }, "position": { "x1": 0, "x2": 0, "y1": 0, "y2": 0 }, "profession": "string", "reconciliation": { "canonical_name": { "confidence": 0, "full_name": "string", "given_names": "string", "language": "string", "script": "string", "source": "mrz", "surname": "string" }, "confidence": 0, "conflicts": [ { "code": "name_mismatch", "field": "string", "left_source": "mrz", "right_source": "mrz", "severity": "string" } ], "decision": "accept", "evidence_sufficient": true, "fixable_by_recapture": true, "model": "string", "mrz": { "decision_source": "string", "independent_available": true, "independent_valid": true, "parsed": { "checks": { "property1": { "expected": "string", "observed": "string", "valid": true }, "property2": { "expected": "string", "observed": "string", "valid": true } }, "date_of_birth": "string", "document_number": "string", "expiry_date": "string", "given_names": "string", "layout": "TD1", "nationality": "string", "raw_lines": [ "string" ], "sex": "string", "surname": "string", "valid": true, "validation_complete": true }, "provider_state": "valid", "provider_validation": "string", "shadow_decision_applied": true, "shadow_state": "valid" }, "names": [ { "confidence": 0, "full_name": "string", "given_names": "string", "language": "string", "script": "string", "source": "mrz", "surname": "string" } ], "recommended_action": "continue" }, "tax_number": "string" }, "personal_number": "string", "place_of_birth": "string", "place_of_issue": "string", "profession": "string", "tax_number": "string" }, "document_front_key": "string", "document_front_url": "string", "document_number": "string", "document_photo_key": "string", "document_photo_url": "string", "document_type": "string", "email": "string", "enrichment": { "scope": "string", "summary": { "bankruptcy_confirmed": true, "call_statuses": { "property1": "string", "property2": "string" }, "completed_at": "string", "hard_block_reason": "string", "match_count": 0, "merged_decision": "string", "merged_risk_score": 0, "observed_at": "string", "passport_invalid": true, "status": "string" } }, "enrichment_errors": [ "string" ], "expiry_date": "string", "expiry_status": "string", "external_id": "string", "face_match_score": 0, "first_name": "string", "full_name": "string", "full_name_latin": "string", "full_name_native": "string", "full_name_original": "string", "id": "string", "identity_projection": { "document_type": "string", "field_sources": { "property1": [ { "document_id": "string", "revision": 0 } ], "property2": [ { "document_id": "string", "revision": 0 } ] }, "ocr": { "additional": { "property1": "string", "property2": "string" }, "address": "string", "barcode": { "property1": "string", "property2": "string" }, "booklet_number": "string", "date_of_birth": "string", "document_class": "string", "document_name": "string", "document_number": "string", "document_series": "string", "document_type": "string", "expiry_date": "string", "field_issues": { "property1": "string", "property2": "string" }, "first_name": "string", "full_name": "string", "full_name_latin": "string", "gender": "string", "issue_date": "string", "issuing_authority": "string", "issuing_authority_name": "string", "issuing_country": "string", "issuing_place": "string", "issuing_state_code": "string", "last_name": "string", "localized": { "property1": { "property1": "string", "property2": "string" }, "property2": { "property1": "string", "property2": "string" } }, "middle_name": "string", "mrz_code": "string", "mrz_data": { "property1": "string", "property2": "string" }, "mrz_type": "string", "nationality": "string", "nationality_name": "string", "native_full_name": "string", "personal_number": "string", "place_of_birth": "string", "portrait": "string", "portrait_position": { "x1": 0, "x2": 0, "y1": 0, "y2": 0 }, "position": { "x1": 0, "x2": 0, "y1": 0, "y2": 0 }, "profession": "string", "reconciliation": { "canonical_name": { "confidence": 0, "full_name": "string", "given_names": "string", "language": "string", "script": "string", "source": "mrz", "surname": "string" }, "confidence": 0, "conflicts": [ { "code": "name_mismatch", "field": "string", "left_source": "mrz", "right_source": "mrz", "severity": "string" } ], "decision": "accept", "evidence_sufficient": true, "fixable_by_recapture": true, "model": "string", "mrz": { "decision_source": "string", "independent_available": true, "independent_valid": true, "parsed": { "checks": { "property1": { "expected": "string", "observed": "string", "valid": true }, "property2": { "expected": "string", "observed": "string", "valid": true } }, "date_of_birth": "string", "document_number": "string", "expiry_date": "string", "given_names": "string", "layout": "TD1", "nationality": "string", "raw_lines": [ "string" ], "sex": "string", "surname": "string", "valid": true, "validation_complete": true }, "provider_state": "valid", "provider_validation": "string", "shadow_decision_applied": true, "shadow_state": "valid" }, "names": [ { "confidence": 0, "full_name": "string", "given_names": "string", "language": "string", "script": "string", "source": "mrz", "surname": "string" } ], "recommended_action": "continue" }, "tax_number": "string" } }, "issuing_country": "string", "issuing_state_code": "string", "last_name": "string", "last_session_id": "string", "last_verified_at": "string", "latest_flow_name": "string", "liveness_mode": "string", "liveness_score": 0, "localized": { "property1": { "property1": "string", "property2": "string" }, "property2": { "property1": "string", "property2": "string" } }, "middle_name": "string", "name_source": { "property1": null, "property2": null }, "nationality": "string", "personal_info": { "address": { "city": "string", "country": "string", "postal_code": "string", "state": "string", "street": "string" }, "date_of_birth": "string", "email": "string", "first_name": "string", "gender": "string", "last_name": "string", "middle_name": "string", "nationality": "string", "ocr_full_name_latin": "string", "ocr_full_name_native": "string", "phone": "string" }, "phone": "string", "photo_url_expires_at": "string", "portrait_photo_key": "string", "portrait_photo_url": "string", "risk_score": 0, "risk_signals": { "property1": null, "property2": null }, "selfie_photo_key": "string", "selfie_photo_url": "string", "session_summary": { "approved": 0, "in_progress": 0, "rejected": 0, "review": 0, "total": 0 }, "sessions": [ { "applicant_id": "string", "completed_at": "string", "context": { "property1": null, "property2": null }, "created_at": "string", "current_step_id": "string", "decision_reasons": [ { "actor": { "display_name": "string", "email": "string", "id": "string", "role": "string", "type": "string" }, "category": "string", "code": "string", "created_at": "string", "details": { "property1": null, "property2": null }, "id": "string", "message": "string", "severity": "string", "source": "string", "step_execution_id": "string", "superseded_at": "string", "superseded_by": "string" } ], "device_info": { "browser_name": "string", "browser_version": "string", "country_code": "string", "device_type": "string", "fingerprint_request_id": "string", "fp_collection_failed": true, "os": "string", "os_version": "string", "timezone": "string", "user_agent": "string" }, "expires_at": "string", "external_id": "string", "fingerprint_visitor_id": "string", "flow_id": "string", "flow_version": 0, "id": "string", "ip_address": "string", "locale": "string", "risk_signals": { "property1": null, "property2": null }, "started_at": "string", "status": "pending", "steps_completed": 0, "user_agent": "string", "verification_link_id": "string", "verification_result": "string", "verification_score": 0 } ], "tenant_id": "string", "updated_at": "string", "verification_score": 0, "verification_status": "pending" }}Get applicant by external ID
Looks up an applicant by the external identifier (external_id) provided when the verification link was created. Required scope: applicants:read.
GET
ApiKeyAuthheader
Authorization<token>HMAC-SHA256 Credential=<key_id>, Signature=<hex_signature>. SignedHeaders=x-timestamp is optional. Requires X-Timestamp header.
external_id*stringExternal user ID
X-Timestamp*stringUnix timestamp (seconds, max 5 min drift)
OK
application/json- response
data?success?booleancurl -X GET 'https://example.com/tenant/v1/kyc/applicants/external/string' \ -H 'X-Timestamp: string'Example Response
{ "success": true, "data": { "address": "string", "aml_decision": "string", "aml_risk_score": 0, "avatar_photo_url": "string", "avatar_url": "string", "client_liveness_score": 0, "created_at": "string", "current_review_decision": { "client_message": "string", "created_at": "string", "decision": "string", "id": "string", "reason_codes": [ "string" ], "scope": "string", "session_id": "string", "step_id": "string" }, "date_of_birth": "string", "details": { "address": { "city": "string", "country": "string", "full_text": "string", "localized": { "property1": { "property1": "string", "property2": "string" }, "property2": { "property1": "string", "property2": "string" } }, "postal_code": "string", "region": "string", "street": "string" }, "barcode": { "fields": { "property1": "string", "property2": "string" }, "raw": "string", "type": "string" }, "document": { "booklet_number": "string", "class": "string", "issuing_authority": "string", "issuing_place": "string", "issuing_state_code": "string", "mrz_type": "string", "series": "string" }, "localized": { "property1": { "property1": "string", "property2": "string" }, "property2": { "property1": "string", "property2": "string" } }, "mrz": { "document_code": "string", "fields": { "property1": "string", "property2": "string" }, "issuing_state": "string", "raw": "string" }, "personal": { "additional_fields": { "property1": "string", "property2": "string" }, "nationality_name": "string", "personal_number": "string", "profession": "string", "tax_number": "string" }, "provider": { "duration_ms": 0, "evidence_reuse": { "execution_id": "string", "reason": "string", "recovery_audit_id": "string", "source_attempt_number": 0, "source_execution_id": "string", "source_verification_id": "string" }, "name": "string", "raw": { "property1": null, "property2": null }, "raw_response_key": "string", "received_at": "string", "request_id": "string", "version": "string" } }, "doc_liveness_score": 0, "document_back_key": "string", "document_back_url": "string", "document_front_key": "string", "document_front_url": "string", "document_number": "string", "document_photo_key": "string", "document_photo_url": "string", "document_type": "string", "email": "string", "enrichment": { "scope": "string", "summary": { "bankruptcy_confirmed": true, "call_statuses": { "property1": "string", "property2": "string" }, "completed_at": "string", "hard_block_reason": "string", "match_count": 0, "merged_decision": "string", "merged_risk_score": 0, "observed_at": "string", "passport_invalid": true, "status": "string" } }, "enrichment_errors": [ "string" ], "expiry_date": "string", "expiry_status": "string", "external_id": "string", "face_match_score": 0, "first_name": "string", "full_name": "string", "full_name_latin": "string", "full_name_native": "string", "full_name_original": "string", "id": "string", "issuing_country": "string", "issuing_state_code": "string", "last_name": "string", "last_session_id": "string", "last_verified_at": "string", "latest_flow_name": "string", "liveness_mode": "string", "liveness_score": 0, "localized": { "property1": { "property1": "string", "property2": "string" }, "property2": { "property1": "string", "property2": "string" } }, "middle_name": "string", "name_source": { "property1": null, "property2": null }, "nationality": "string", "phone": "string", "photo_url_expires_at": "string", "portrait_photo_key": "string", "portrait_photo_url": "string", "risk_score": 0, "risk_signals": { "property1": null, "property2": null }, "selfie_photo_key": "string", "selfie_photo_url": "string", "session_summary": { "approved": 0, "in_progress": 0, "rejected": 0, "review": 0, "total": 0 }, "updated_at": "string", "verification_score": 0, "verification_status": "pending" }}Applicant verification sessions
Returns all verification sessions linked to the applicant. Required scope: applicants:read.
GET
ApiKeyAuthheader
Authorization<token>HMAC-SHA256 Credential=<key_id>, Signature=<hex_signature>. SignedHeaders=x-timestamp is optional. Requires X-Timestamp header.
applicant_id*stringApplicant UUID
X-Timestamp*stringUnix timestamp (seconds, max 5 min drift)
Sessions list
application/json- response
data?array<>pagination?success?booleancurl -X GET 'https://example.com/tenant/v1/kyc/applicants/string/sessions' \ -H 'X-Timestamp: string'Example Response
{ "pagination": { "has_more": true, "limit": 0, "next_cursor": "string", "offset": 0, "total": 0 }, "success": true, "data": [ { "applicant_id": "string", "completed_at": "string", "context": { "property1": null, "property2": null }, "created_at": "string", "current_step_id": "string", "decision_reasons": [ { "actor": { "display_name": "string", "email": "string", "id": "string", "role": "string", "type": "string" }, "category": "string", "code": "string", "created_at": "string", "details": { "property1": null, "property2": null }, "id": "string", "message": "string", "severity": "string", "source": "string", "step_execution_id": "string", "superseded_at": "string", "superseded_by": "string" } ], "device_info": { "browser_name": "string", "browser_version": "string", "country_code": "string", "device_type": "string", "fingerprint_request_id": "string", "fp_collection_failed": true, "os": "string", "os_version": "string", "timezone": "string", "user_agent": "string" }, "expires_at": "string", "external_id": "string", "fingerprint_visitor_id": "string", "flow_id": "string", "flow_version": 0, "id": "string", "ip_address": "string", "locale": "string", "risk_signals": { "property1": null, "property2": null }, "started_at": "string", "status": "pending", "steps_completed": 0, "user_agent": "string", "verification_link_id": "string", "verification_result": "string", "verification_score": 0 } ]}Applicant history
Returns the chronological event log for the applicant (creation, status updates, check results). Required scope: applicants:read.
GET
ApiKeyAuthheader
Authorization<token>HMAC-SHA256 Credential=<key_id>, Signature=<hex_signature>. SignedHeaders=x-timestamp is optional. Requires X-Timestamp header.
applicant_id*stringApplicant UUID
X-Timestamp*stringUnix timestamp (seconds, max 5 min drift)
History list
application/json- response
data?array<>pagination?success?booleancurl -X GET 'https://example.com/tenant/v1/kyc/applicants/string/history' \ -H 'X-Timestamp: string'Example Response
{ "pagination": { "has_more": true, "limit": 0, "next_cursor": "string", "offset": 0, "total": 0 }, "success": true, "data": [ { "changed_by": "string", "details": { "property1": null, "property2": null }, "previous_status": "string", "reason": "string", "status": "string", "timestamp": "string" } ]}Verification result
Returns the final verification result for the applicant, including the decision
status, check details, and contact fields (email, phone) from the applicant
record. Check details include the normalized ocr, doc_liveness,
face_liveness, and face_match blocks when those checks are present.
Required scope: verifications:read.
GET
ApiKeyAuthheader
Authorization<token>HMAC-SHA256 Credential=<key_id>, Signature=<hex_signature>. SignedHeaders=x-timestamp is optional. Requires X-Timestamp header.
applicant_id*stringApplicant UUID
X-Timestamp*stringUnix timestamp (seconds, max 5 min drift)
OK
application/json- response
data?success?booleancurl -X GET 'https://example.com/tenant/v1/kyc/applicants/string/verification' \ -H 'X-Timestamp: string'Example Response
{ "success": true, "data": { "applicant_id": "string", "checks": [ { "aml": { "aml_screening_completed": true, "aml_screening_status": "string", "aml_service_unavailable": true, "checks": { "property1": "string", "property2": "string" }, "checks_typed": [ { "checked_at": "string", "hit_count": 0, "list_id": "string", "list_name": "string", "status": "string" } ], "compliance": { "bankruptcy": { "address": "string", "bankrupt_date": "string", "matched_inn": "string", "snils": "string", "stage": "string", "stage_date": "string" }, "passport": { "invalid_since": "string", "is_invalid": true, "passport_number": "string" }, "rkl": { "document_number": "string", "in_registry": true } }, "decision": "string", "effective_list_actions": { "property1": "string", "property2": "string" }, "effective_match_policy": { "match_strength": "string", "match_strength_per_list": { "property1": "string", "property2": "string" }, "min_match_confidence": 0 }, "error_code": "string", "error_message": "string", "forced_review_reason": "string", "input_fields_used": [ "string" ], "lists_checked": [ "string" ], "localized": { "property1": { "property1": "string", "property2": "string" }, "property2": { "property1": "string", "property2": "string" } }, "match_details": [ { "property1": null, "property2": null } ], "match_found": true, "match_severity": "string", "matched_lists": [ "string" ], "matches": [ { "confidence": 0, "hit_details": { "additional_information": [ { "label": "string", "value": "string" } ], "additional_sanctions": [ "string" ], "country": "string", "crypto_wallets": [ "string" ], "delisted_at": "string", "description": "string", "education": [ "string" ], "email_addresses": [ "string" ], "last_updated": "string", "listed_at": "string", "notes": "string", "phone_numbers": [ "string" ], "position": "string", "programs": [ "string" ], "remarks": "string", "risk_categories": [ "string" ], "source_links": [ "string" ], "source_url": "string", "websites": [ "string" ] }, "list_category": "string", "list_id": "string", "list_name": "string", "localized": { "property1": { "property1": "string", "property2": "string" }, "property2": { "property1": "string", "property2": "string" } }, "match_fields": [ "string" ], "match_strength": "string", "person": { "aliases": [ "string" ], "birth_place": "string", "citizenship": "string", "date_of_birth": "string", "documents": [ { "class": "string", "country": "string", "expiration_date": "string", "issue_date": "string", "number": "string", "type": "string" } ], "first_name": "string", "full_name": "string", "gender": "string", "last_name": "string", "localized": { "property1": { "property1": "string", "property2": "string" }, "property2": { "property1": "string", "property2": "string" } }, "middle_name": "string", "nationality": "string" }, "provenance": { "raw_record": { "property1": null, "property2": null }, "vendor_list_id": "string", "vendor_match_id": "string", "vendor_source_id": "string" } } ], "provider": "string", "provider_metadata": { "duration_ms": 0, "evidence_reuse": { "execution_id": "string", "reason": "string", "recovery_audit_id": "string", "source_attempt_number": 0, "source_execution_id": "string", "source_verification_id": "string" }, "name": "string", "raw": { "property1": null, "property2": null }, "raw_response_key": "string", "received_at": "string", "request_id": "string", "version": "string" }, "providers_called": [ "string" ], "providers_errored": [ "string" ], "providers_succeeded": [ "string" ], "risk_score": 0, "unchecked_lists": [ "string" ] }, "attempt_number": 0, "completed_at": "string", "doc_liveness": { "is_real": true, "portrait_replace": 0, "printed_copy": 0, "result_code": "string", "score": 0, "screen_replay": 0, "status": "string", "status_error": "string", "thresholds": { "portrait_replace": 0, "printed_copy": 0, "screen_replay": 0 } }, "face_liveness": { "face_warnings": [ "string" ], "faces": [ { "eye_dist": 0, "face_luminance": 0, "face_occlusion": 0, "face_quality": 0, "landmark_68": [ { "x": 0, "y": 0 } ], "left_eye_closed": 0, "mouth_opened": 0, "pitch": 0, "right_eye_closed": 0, "roll": 0, "state": { "eye_closed": true, "has_mouth_open": true, "has_occlusion": true, "is_boundary_face": true, "is_front": true, "is_not_front": true, "is_small": true, "luminance": "string", "quality": "string", "result": "string" }, "x1": 0, "x2": 0, "y1": 0, "y2": 0, "yaw": 0 } ], "is_live": true, "message": "string", "quality": 0, "quality_warning_reason": "string", "score": 0, "status": "string", "threshold": 0 }, "face_match": { "confidence_level": "string", "face1_index": 0, "face2_index": 0, "faces1": [ { "eye_dist": 0, "face_luminance": 0, "face_occlusion": 0, "face_quality": 0, "landmark_68": [ { "x": 0, "y": 0 } ], "left_eye_closed": 0, "mouth_opened": 0, "pitch": 0, "right_eye_closed": 0, "roll": 0, "state": { "eye_closed": true, "has_mouth_open": true, "has_occlusion": true, "is_boundary_face": true, "is_front": true, "is_not_front": true, "is_small": true, "luminance": "string", "quality": "string", "result": "string" }, "x1": 0, "x2": 0, "y1": 0, "y2": 0, "yaw": 0 } ], "faces2": [ { "eye_dist": 0, "face_luminance": 0, "face_occlusion": 0, "face_quality": 0, "landmark_68": [ { "x": 0, "y": 0 } ], "left_eye_closed": 0, "mouth_opened": 0, "pitch": 0, "right_eye_closed": 0, "roll": 0, "state": { "eye_closed": true, "has_mouth_open": true, "has_occlusion": true, "is_boundary_face": true, "is_front": true, "is_not_front": true, "is_small": true, "luminance": "string", "quality": "string", "result": "string" }, "x1": 0, "x2": 0, "y1": 0, "y2": 0, "yaw": 0 } ], "is_match": true, "result_code": "string", "score": 0, "threshold": 0 }, "kyb": { "activities": [ { "code": "string", "description": "string", "is_primary": true } ], "activities_evidence_sources": [ "string" ], "activities_typed": [ { "code": "string", "description": "string", "is_primary": true, "localized": { "property1": { "property1": "string", "property2": "string" }, "property2": { "property1": "string", "property2": "string" } }, "name": "string", "system": "string" } ], "activities_unavailable_reason_info": "string", "actual_address": "string", "additional_url": "string", "additional_url_evidence_sources": [ "string" ], "additional_url_unavailable_reason_info": "string", "addresses_typed": [ { "address": { "city": "string", "country": "string", "full_text": "string", "localized": { "property1": { "property1": "string", "property2": "string" }, "property2": { "property1": "string", "property2": "string" } }, "postal_code": "string", "region": "string", "street": "string" }, "type": "string", "valid_from": "string", "valid_to": "string" } ], "adverse_media": [ { "categories": [ "string" ], "language": "string", "localized": { "property1": { "property1": "string", "property2": "string" }, "property2": { "property1": "string", "property2": "string" } }, "published_at": "string", "severity": "string", "source": "string", "summary": "string", "title": "string", "url": "string" } ], "ai_analysis": { "confidence": 0, "confirmation_flag": true, "green_flags": [ "string" ], "localized": { "property1": { "property1": "string", "property2": "string" }, "property2": { "property1": "string", "property2": "string" } }, "model_version": "string", "red_flags": [ "string" ], "summary": "string" }, "bankruptcy": { "case_number": "string", "court": "string", "is_bankrupt": true, "localized": { "property1": { "property1": "string", "property2": "string" }, "property2": { "property1": "string", "property2": "string" } }, "receiver": "string", "stage": "string", "started_at": "string" }, "beneficiaries": [ { "is_director": true, "name": "string", "ownership": 0 } ], "beneficiaries_evidence_sources": [ "string" ], "beneficiaries_typed": [ { "addresses": [ { "address": { "city": "string", "country": "string", "full_text": "string", "localized": { "property1": { "property1": "string", "property2": "string" }, "property2": { "property1": "string", "property2": "string" } }, "postal_code": "string", "region": "string", "street": "string" }, "type": "string", "valid_from": "string", "valid_to": "string" } ], "appointed_at": "string", "date_of_birth": "string", "documents": [ { "class": "string", "country": "string", "expiration_date": "string", "issue_date": "string", "number": "string", "type": "string" } ], "first_name": "string", "full_name": "string", "id": "string", "is_pep": true, "is_sanctioned": true, "last_name": "string", "localized": { "property1": { "property1": "string", "property2": "string" }, "property2": { "property1": "string", "property2": "string" } }, "middle_name": "string", "nationality": "string", "ownership_pct": 0, "resigned_at": "string", "role": "string", "role_raw": "string", "tax_id": "string" } ], "beneficiaries_unavailable_reason_info": "string", "company_aliases": [ "string" ], "company_code": "string", "company_name": "string", "confirmation_flag": true, "confirmation_tier": "string", "consulted_sources": [ "string" ], "country": "string", "decision": "string", "decision_reason": "string", "director_evidence_sources": [ "string" ], "director_name": "string", "director_title": "string", "director_unavailable_reason_info": "string", "directors_typed": [ { "addresses": [ { "address": { "city": "string", "country": "string", "full_text": "string", "localized": { "property1": { "property1": "string", "property2": "string" }, "property2": { "property1": "string", "property2": "string" } }, "postal_code": "string", "region": "string", "street": "string" }, "type": "string", "valid_from": "string", "valid_to": "string" } ], "appointed_at": "string", "date_of_birth": "string", "documents": [ { "class": "string", "country": "string", "expiration_date": "string", "issue_date": "string", "number": "string", "type": "string" } ], "first_name": "string", "full_name": "string", "id": "string", "is_pep": true, "is_sanctioned": true, "last_name": "string", "localized": { "property1": { "property1": "string", "property2": "string" }, "property2": { "property1": "string", "property2": "string" } }, "middle_name": "string", "nationality": "string", "ownership_pct": 0, "resigned_at": "string", "role": "string", "role_raw": "string", "tax_id": "string" } ], "field_evidence": [ { "confidence": 0, "declared_value": "string", "document_source": "string", "document_value": "string", "field": "string", "match_status": "string", "provider": "string", "provider_value": "string", "reason_code": "string", "severity": "string" } ], "financials": { "assets": 0, "authorized_capital": 0, "currency": "string", "employee_count": 0, "employee_date": "string", "equity": 0, "fiscal_year": 0, "liabilities": 0, "net_profit": 0, "report_source": "string", "revenue": 0 }, "incorporation_country": "string", "incorporation_date": "string", "legal_address": "string", "legal_form": "string", "legal_form_raw": "string", "lei": "string", "liquidation_date": "string", "litigation": [ { "amount": 0, "case_number": "string", "closed_at": "string", "court": "string", "currency": "string", "filed_at": "string", "localized": { "property1": { "property1": "string", "property2": "string" }, "property2": { "property1": "string", "property2": "string" } }, "role": "string", "status": "string", "subject": "string" } ], "localized": { "property1": { "property1": "string", "property2": "string" }, "property2": { "property1": "string", "property2": "string" } }, "lookup_coverage_tier": "string", "lookup_next_actions": [ { "action": "string", "detail": "string", "identifiers": [ "string" ], "label": "string", "provider": "string", "url": "string" } ], "lookup_outcome": { "auto_approval_eligible": true, "coverage_tier": "string", "decision_bias": "string", "next_actions": [ { "action": "string", "detail": "string", "identifiers": [ "string" ], "label": "string", "provider": "string", "url": "string" } ], "official_source_count": 0, "provider_statuses": [ { "detail": "string", "provider": "string", "status": "string" } ], "reason": "string", "registry_authority_hint": [ "string" ], "requires_manual_review": true, "secondary_source_count": 0 }, "lookup_outcome_reason": "string", "main_url": "string", "main_url_evidence_sources": [ "string" ], "main_url_unavailable_reason_info": "string", "notes": "string", "pep": [ { "confidence": 0, "hit_details": { "additional_information": [ { "label": "string", "value": "string" } ], "additional_sanctions": [ "string" ], "country": "string", "crypto_wallets": [ "string" ], "delisted_at": "string", "description": "string", "education": [ "string" ], "email_addresses": [ "string" ], "last_updated": "string", "listed_at": "string", "notes": "string", "phone_numbers": [ "string" ], "position": "string", "programs": [ "string" ], "remarks": "string", "risk_categories": [ "string" ], "source_links": [ "string" ], "source_url": "string", "websites": [ "string" ] }, "list_category": "string", "list_id": "string", "list_name": "string", "localized": { "property1": { "property1": "string", "property2": "string" }, "property2": { "property1": "string", "property2": "string" } }, "match_fields": [ "string" ], "match_strength": "string", "person": { "aliases": [ "string" ], "birth_place": "string", "citizenship": "string", "date_of_birth": "string", "documents": [ { "class": "string", "country": "string", "expiration_date": "string", "issue_date": "string", "number": "string", "type": "string" } ], "first_name": "string", "full_name": "string", "gender": "string", "last_name": "string", "localized": { "property1": { "property1": "string", "property2": "string" }, "property2": { "property1": "string", "property2": "string" } }, "middle_name": "string", "nationality": "string" }, "provenance": { "raw_record": { "property1": null, "property2": null }, "vendor_list_id": "string", "vendor_match_id": "string", "vendor_source_id": "string" } } ], "proprietor_name": "string", "provider_metadata": { "duration_ms": 0, "evidence_reuse": { "execution_id": "string", "reason": "string", "recovery_audit_id": "string", "source_attempt_number": 0, "source_execution_id": "string", "source_verification_id": "string" }, "name": "string", "raw": { "property1": null, "property2": null }, "raw_response_key": "string", "received_at": "string", "request_id": "string", "version": "string" }, "provider_statuses": [ { "detail": "string", "provider": "string", "retrieved_at": "string", "status": "string" } ], "reconciliation_decision": "string", "reconciliation_reason_codes": [ "string" ], "registration_date": "string", "registration_number": "string", "registry_facts": [ { "company_aliases": [ "string" ], "company_name": "string", "confidence": 0, "country": "string", "director_names": [ "string" ], "incorporation_date": "string", "legal_address": "string", "lei": "string", "provider": "string", "registration_date": "string", "registration_number": "string", "source_retrieved_at": "string", "source_url": "string", "status": "string", "tax_number": "string", "website": "string" } ], "risk_factors": [ { "category": "string", "code": "string", "description": "string", "localized": { "property1": { "property1": "string", "property2": "string" }, "property2": { "property1": "string", "property2": "string" } }, "severity": "string", "weight": 0 } ], "risk_level": "string", "risk_score": 0, "sanctions": [ { "confidence": 0, "hit_details": { "additional_information": [ { "label": "string", "value": "string" } ], "additional_sanctions": [ "string" ], "country": "string", "crypto_wallets": [ "string" ], "delisted_at": "string", "description": "string", "education": [ "string" ], "email_addresses": [ "string" ], "last_updated": "string", "listed_at": "string", "notes": "string", "phone_numbers": [ "string" ], "position": "string", "programs": [ "string" ], "remarks": "string", "risk_categories": [ "string" ], "source_links": [ "string" ], "source_url": "string", "websites": [ "string" ] }, "list_category": "string", "list_id": "string", "list_name": "string", "localized": { "property1": { "property1": "string", "property2": "string" }, "property2": { "property1": "string", "property2": "string" } }, "match_fields": [ "string" ], "match_strength": "string", "person": { "aliases": [ "string" ], "birth_place": "string", "citizenship": "string", "date_of_birth": "string", "documents": [ { "class": "string", "country": "string", "expiration_date": "string", "issue_date": "string", "number": "string", "type": "string" } ], "first_name": "string", "full_name": "string", "gender": "string", "last_name": "string", "localized": { "property1": { "property1": "string", "property2": "string" }, "property2": { "property1": "string", "property2": "string" } }, "middle_name": "string", "nationality": "string" }, "provenance": { "raw_record": { "property1": null, "property2": null }, "vendor_list_id": "string", "vendor_match_id": "string", "vendor_source_id": "string" } } ], "shareholders": [ { "addresses": [ { "address": { "city": "string", "country": "string", "full_text": "string", "localized": { "property1": { "property1": "string", "property2": "string" }, "property2": { "property1": "string", "property2": "string" } }, "postal_code": "string", "region": "string", "street": "string" }, "type": "string", "valid_from": "string", "valid_to": "string" } ], "appointed_at": "string", "date_of_birth": "string", "documents": [ { "class": "string", "country": "string", "expiration_date": "string", "issue_date": "string", "number": "string", "type": "string" } ], "first_name": "string", "full_name": "string", "id": "string", "is_pep": true, "is_sanctioned": true, "last_name": "string", "localized": { "property1": { "property1": "string", "property2": "string" }, "property2": { "property1": "string", "property2": "string" } }, "middle_name": "string", "nationality": "string", "ownership_pct": 0, "resigned_at": "string", "role": "string", "role_raw": "string", "tax_id": "string" } ], "signatories": [ { "addresses": [ { "address": { "city": "string", "country": "string", "full_text": "string", "localized": { "property1": { "property1": "string", "property2": "string" }, "property2": { "property1": "string", "property2": "string" } }, "postal_code": "string", "region": "string", "street": "string" }, "type": "string", "valid_from": "string", "valid_to": "string" } ], "appointed_at": "string", "date_of_birth": "string", "documents": [ { "class": "string", "country": "string", "expiration_date": "string", "issue_date": "string", "number": "string", "type": "string" } ], "first_name": "string", "full_name": "string", "id": "string", "is_pep": true, "is_sanctioned": true, "last_name": "string", "localized": { "property1": { "property1": "string", "property2": "string" }, "property2": { "property1": "string", "property2": "string" } }, "middle_name": "string", "nationality": "string", "ownership_pct": 0, "resigned_at": "string", "role": "string", "role_raw": "string", "tax_id": "string" } ], "sources": [ "string" ], "status": "string", "status_date": "string", "status_evidence_sources": [ "string" ], "status_info": "string", "summary": "string", "suspicious_signals": [ "string" ], "tax_number": "string", "trade_name": "string", "trading_name": "string" }, "ocr": { "additional": { "property1": "string", "property2": "string" }, "address": "string", "barcode": { "property1": "string", "property2": "string" }, "booklet_number": "string", "date_of_birth": "string", "document_class": "string", "document_name": "string", "document_number": "string", "document_series": "string", "document_type": "string", "expiry_date": "string", "field_issues": { "property1": "string", "property2": "string" }, "first_name": "string", "full_name": "string", "full_name_latin": "string", "gender": "string", "issue_date": "string", "issuing_authority": "string", "issuing_authority_name": "string", "issuing_country": "string", "issuing_place": "string", "issuing_state_code": "string", "last_name": "string", "localized": { "property1": { "property1": "string", "property2": "string" }, "property2": { "property1": "string", "property2": "string" } }, "middle_name": "string", "mrz_code": "string", "mrz_data": { "property1": "string", "property2": "string" }, "mrz_type": "string", "nationality": "string", "nationality_name": "string", "native_full_name": "string", "personal_number": "string", "place_of_birth": "string", "portrait": "string", "portrait_position": { "x1": 0, "x2": 0, "y1": 0, "y2": 0 }, "position": { "x1": 0, "x2": 0, "y1": 0, "y2": 0 }, "profession": "string", "reconciliation": { "canonical_name": { "confidence": 0, "full_name": "string", "given_names": "string", "language": "string", "script": "string", "source": "mrz", "surname": "string" }, "confidence": 0, "conflicts": [ { "code": "name_mismatch", "field": "string", "left_source": "mrz", "right_source": "mrz", "severity": "string" } ], "decision": "accept", "evidence_sufficient": true, "fixable_by_recapture": true, "model": "string", "mrz": { "decision_source": "string", "independent_available": true, "independent_valid": true, "parsed": { "checks": { "property1": { "expected": "string", "observed": "string", "valid": true }, "property2": { "expected": "string", "observed": "string", "valid": true } }, "date_of_birth": "string", "document_number": "string", "expiry_date": "string", "given_names": "string", "layout": "TD1", "nationality": "string", "raw_lines": [ "string" ], "sex": "string", "surname": "string", "valid": true, "validation_complete": true }, "provider_state": "valid", "provider_validation": "string", "shadow_decision_applied": true, "shadow_state": "valid" }, "names": [ { "confidence": 0, "full_name": "string", "given_names": "string", "language": "string", "script": "string", "source": "mrz", "surname": "string" } ], "recommended_action": "continue" }, "tax_number": "string" }, "proof_of_address": { "address_apartment_present": true, "address_building_present": true, "address_city": "string", "address_country": "string", "address_display": "string", "address_line1_present": true, "address_line2_present": true, "address_postal_code": "string", "address_source": "string", "address_street_present": true, "address_subdivision": "string", "applicant_message_code": "string", "blocked_keyword_count": 0, "config_source": "string", "config_version": 0, "decision": "string", "document_address_geocode_components": [ { "evidence_present": true, "expected_value": "string", "field": "string", "matched": true, "matched_token": "string", "normalized_expected": "string", "normalized_observed": "string", "observed_confidence": 0, "observed_source": "string", "observed_value": "string", "required": true, "weight": 0 } ], "document_address_geocode_confidence_bucket": "string", "document_address_geocode_distance_bucket": "string", "document_address_geocode_expected_display": "string", "document_address_geocode_observed_display": "string", "document_address_geocode_score_bucket": "string", "document_address_geocode_status": "string", "document_address_match_components": [ { "evidence_present": true, "expected_value": "string", "field": "string", "matched": true, "matched_token": "string", "normalized_expected": "string", "normalized_observed": "string", "observed_confidence": 0, "observed_source": "string", "observed_value": "string", "required": true, "weight": 0 } ], "document_address_match_score_bucket": "string", "document_address_match_status": "string", "document_address_matched": true, "document_available": true, "document_category": "string", "document_classification_accepted": true, "document_classification_category": "string", "document_classification_confidence_bucket": "string", "document_classification_negative_signals": "string", "document_classification_positive_signals": "string", "document_classification_status": "string", "document_classification_subtype": "string", "document_country": "string", "document_language": "string", "document_ocr_confidence_bucket": "string", "document_ocr_degraded": true, "document_ocr_extracted_bytes": 0, "document_ocr_text_snippet": "string", "document_ocr_text_truncated": true, "document_page_count": 0, "document_screenshot": true, "document_subtype": "string", "document_unsupported_reason": "string", "fingerprint_state": "string", "gps_accuracy_meters": 0, "gps_address_distance_bucket": "string", "gps_address_distance_meters": 0, "gps_address_match_radius_meters": 0, "gps_address_mismatch_radius_meters": 0, "gps_address_proximity_status": "string", "gps_country": "string", "gps_geocode_confidence_bucket": "string", "gps_signal_status": "string", "ip_accuracy_radius_bucket": "string", "ip_connection_type": "string", "ip_country": "string", "ip_country_confidence_bucket": "string", "ip_expected": "string", "ip_signal_status": "string", "reason_codes": [ "string" ], "reviewer_summary": "string", "route": "string" }, "rejection_reasons": [ "string" ], "score": 0, "status": "string", "step_id": "string", "type": "string", "verification_id": "string" } ], "completed_at": "string", "custom_steps": [ { "config": { "fields": [ { "data_type": "string", "id": "string", "label": "string", "max_length": 0, "min_length": 0, "required": true, "validation_preset": "string" } ], "lists": [ { "black_list_items_count": 0, "display": "string", "grey_list_items_count": 0, "id": "string", "label": "string", "multiple": true, "required": true, "selected_value_ids": [ "string" ], "value_policy": "string", "values_count": 0 } ], "mode": "string" }, "decision": { "action": "string", "code": "string", "list_id": "string", "list_label": "string", "match_type": "string", "status": "string" }, "execution_id": "string", "fields": [ { "key": "string", "label": "string", "value": "string" } ], "lists": [ { "key": "string", "label": "string", "values": [ { "id": "string", "label": "string" } ] } ], "step_id": "string", "step_key": "string", "step_name": "string" } ], "email": "string", "phone": "string", "risk_score": 0, "session_id": "string", "status": "string" }}AML screening result
Returns the result of sanctions and PEP screening (when the flow contains an AML step). Required scope: verifications:read.
GET
ApiKeyAuthheader
Authorization<token>HMAC-SHA256 Credential=<key_id>, Signature=<hex_signature>. SignedHeaders=x-timestamp is optional. Requires X-Timestamp header.
applicant_id*stringApplicant UUID
X-Timestamp*stringUnix timestamp (seconds, max 5 min drift)
OK
application/json- response
data?success?booleancurl -X GET 'https://example.com/tenant/v1/kyc/applicants/string/aml' \ -H 'X-Timestamp: string'Example Response
{ "success": true, "data": { "aml": { "aml_screening_completed": true, "aml_screening_status": "string", "aml_service_unavailable": true, "checks": { "property1": "string", "property2": "string" }, "checks_typed": [ { "checked_at": "string", "hit_count": 0, "list_id": "string", "list_name": "string", "status": "string" } ], "compliance": { "bankruptcy": { "address": "string", "bankrupt_date": "string", "matched_inn": "string", "snils": "string", "stage": "string", "stage_date": "string" }, "passport": { "invalid_since": "string", "is_invalid": true, "passport_number": "string" }, "rkl": { "document_number": "string", "in_registry": true } }, "decision": "string", "effective_list_actions": { "property1": "string", "property2": "string" }, "effective_match_policy": { "match_strength": "string", "match_strength_per_list": { "property1": "string", "property2": "string" }, "min_match_confidence": 0 }, "error_code": "string", "error_message": "string", "forced_review_reason": "string", "input_fields_used": [ "string" ], "lists_checked": [ "string" ], "localized": { "property1": { "property1": "string", "property2": "string" }, "property2": { "property1": "string", "property2": "string" } }, "match_details": [ { "property1": null, "property2": null } ], "match_found": true, "match_severity": "string", "matched_lists": [ "string" ], "matches": [ { "confidence": 0, "hit_details": { "additional_information": [ { "label": "string", "value": "string" } ], "additional_sanctions": [ "string" ], "country": "string", "crypto_wallets": [ "string" ], "delisted_at": "string", "description": "string", "education": [ "string" ], "email_addresses": [ "string" ], "last_updated": "string", "listed_at": "string", "notes": "string", "phone_numbers": [ "string" ], "position": "string", "programs": [ "string" ], "remarks": "string", "risk_categories": [ "string" ], "source_links": [ "string" ], "source_url": "string", "websites": [ "string" ] }, "list_category": "string", "list_id": "string", "list_name": "string", "localized": { "property1": { "property1": "string", "property2": "string" }, "property2": { "property1": "string", "property2": "string" } }, "match_fields": [ "string" ], "match_strength": "string", "person": { "aliases": [ "string" ], "birth_place": "string", "citizenship": "string", "date_of_birth": "string", "documents": [ { "class": "string", "country": "string", "expiration_date": "string", "issue_date": "string", "number": "string", "type": "string" } ], "first_name": "string", "full_name": "string", "gender": "string", "last_name": "string", "localized": { "property1": { "property1": "string", "property2": "string" }, "property2": { "property1": "string", "property2": "string" } }, "middle_name": "string", "nationality": "string" }, "provenance": { "raw_record": { "property1": null, "property2": null }, "vendor_list_id": "string", "vendor_match_id": "string", "vendor_source_id": "string" } } ], "provider": "string", "provider_metadata": { "duration_ms": 0, "evidence_reuse": { "execution_id": "string", "reason": "string", "recovery_audit_id": "string", "source_attempt_number": 0, "source_execution_id": "string", "source_verification_id": "string" }, "name": "string", "raw": { "property1": null, "property2": null }, "raw_response_key": "string", "received_at": "string", "request_id": "string", "version": "string" }, "providers_called": [ "string" ], "providers_errored": [ "string" ], "providers_succeeded": [ "string" ], "risk_score": 0, "unchecked_lists": [ "string" ] }, "aml_provider_info": { "forced_review_reason": "string", "providers_called": [ "string" ], "providers_errored": [ "string" ], "providers_succeeded": [ "string" ], "service_unavailable": true, "unchecked_lists": [ "string" ] }, "aml_screening_completed": true, "aml_screening_status": "string", "applicant_id": "string", "attempt_number": 0, "checks": { "property1": "string", "property2": "string" }, "checks_typed": [ { "checked_at": "string", "hit_count": 0, "list_id": "string", "list_name": "string", "status": "string" } ], "decision": "string", "error_code": "string", "error_message": "string", "hits": [ { "decision": "string", "list_type": "string", "status": "string" } ], "lists_checked": [ "string" ], "localized": { "property1": { "property1": "string", "property2": "string" }, "property2": { "property1": "string", "property2": "string" } }, "match_details": [ { "property1": null, "property2": null } ], "match_severity": "string", "matched_lists": [ "string" ], "matches": [ { "confidence": 0, "hit_details": { "additional_information": [ { "label": "string", "value": "string" } ], "additional_sanctions": [ "string" ], "country": "string", "crypto_wallets": [ "string" ], "delisted_at": "string", "description": "string", "education": [ "string" ], "email_addresses": [ "string" ], "last_updated": "string", "listed_at": "string", "notes": "string", "phone_numbers": [ "string" ], "position": "string", "programs": [ "string" ], "remarks": "string", "risk_categories": [ "string" ], "source_links": [ "string" ], "source_url": "string", "websites": [ "string" ] }, "list_category": "string", "list_id": "string", "list_name": "string", "localized": { "property1": { "property1": "string", "property2": "string" }, "property2": { "property1": "string", "property2": "string" } }, "match_fields": [ "string" ], "match_strength": "string", "person": { "aliases": [ "string" ], "birth_place": "string", "citizenship": "string", "date_of_birth": "string", "documents": [ { "class": "string", "country": "string", "expiration_date": "string", "issue_date": "string", "number": "string", "type": "string" } ], "first_name": "string", "full_name": "string", "gender": "string", "last_name": "string", "localized": { "property1": { "property1": "string", "property2": "string" }, "property2": { "property1": "string", "property2": "string" } }, "middle_name": "string", "nationality": "string" }, "provenance": { "raw_record": { "property1": null, "property2": null }, "vendor_list_id": "string", "vendor_match_id": "string", "vendor_source_id": "string" } } ], "provider": "string", "provider_metadata": { "duration_ms": 0, "evidence_reuse": { "execution_id": "string", "reason": "string", "recovery_audit_id": "string", "source_attempt_number": 0, "source_execution_id": "string", "source_verification_id": "string" }, "name": "string", "raw": { "property1": null, "property2": null }, "raw_response_key": "string", "received_at": "string", "request_id": "string", "version": "string" }, "risk_score": 0, "screened_at": "string", "session_id": "string", "status": "string", "step_id": "string", "summary": { "property1": 0, "property2": 0 }, "verification_id": "string" }}Applicant documents
Returns the list of documents uploaded by the applicant during verification.
When OCR data is available, extracted_data includes the standard document
fields plus extended_data for additional provider-normalized OCR fields.
Required scope: documents:read.
GET
ApiKeyAuthheader
Authorization<token>HMAC-SHA256 Credential=<key_id>, Signature=<hex_signature>. SignedHeaders=x-timestamp is optional. Requires X-Timestamp header.
applicant_id*stringApplicant UUID
X-Timestamp*stringUnix timestamp (seconds, max 5 min drift)
Documents list
application/json- response
data?array<>pagination?success?booleancurl -X GET 'https://example.com/tenant/v1/kyc/applicants/string/documents' \ -H 'X-Timestamp: string'Example Response
{ "pagination": { "has_more": true, "limit": 0, "next_cursor": "string", "offset": 0, "total": 0 }, "success": true, "data": [ { "attempt_number": 0, "collection": { "doc_liveness": { "is_real": true, "portrait_replace": 0, "printed_copy": 0, "result_code": "string", "score": 0, "screen_replay": 0, "status": "string", "status_error": "string", "thresholds": { "portrait_replace": 0, "printed_copy": 0, "screen_replay": 0 } }, "doc_liveness_sides": { "property1": { "is_real": true, "portrait_replace": 0, "printed_copy": 0, "result_code": "string", "score": 0, "screen_replay": 0, "status": "string", "status_error": "string", "thresholds": { "portrait_replace": 0, "printed_copy": 0, "screen_replay": 0 } }, "property2": { "is_real": true, "portrait_replace": 0, "printed_copy": 0, "result_code": "string", "score": 0, "screen_replay": 0, "status": "string", "status_error": "string", "thresholds": { "portrait_replace": 0, "printed_copy": 0, "screen_replay": 0 } } }, "document_metadata": { "back_file_id": "string", "front_file_id": "string", "portrait_file_id": "string", "primary_file_id": "string" }, "document_order": 0, "logical_document_id": "string", "ocr": { "additional": { "property1": "string", "property2": "string" }, "address": "string", "barcode": { "property1": "string", "property2": "string" }, "booklet_number": "string", "date_of_birth": "string", "document_class": "string", "document_name": "string", "document_number": "string", "document_series": "string", "document_type": "string", "expiry_date": "string", "field_issues": { "property1": "string", "property2": "string" }, "first_name": "string", "full_name": "string", "full_name_latin": "string", "gender": "string", "issue_date": "string", "issuing_authority": "string", "issuing_authority_name": "string", "issuing_country": "string", "issuing_place": "string", "issuing_state_code": "string", "last_name": "string", "localized": { "property1": { "property1": "string", "property2": "string" }, "property2": { "property1": "string", "property2": "string" } }, "middle_name": "string", "mrz_code": "string", "mrz_data": { "property1": "string", "property2": "string" }, "mrz_type": "string", "nationality": "string", "nationality_name": "string", "native_full_name": "string", "personal_number": "string", "place_of_birth": "string", "portrait": "string", "portrait_position": { "x1": 0, "x2": 0, "y1": 0, "y2": 0 }, "position": { "x1": 0, "x2": 0, "y1": 0, "y2": 0 }, "profession": "string", "reconciliation": { "canonical_name": { "confidence": 0, "full_name": "string", "given_names": "string", "language": "string", "script": "string", "source": "mrz", "surname": "string" }, "confidence": 0, "conflicts": [ { "code": "name_mismatch", "field": "string", "left_source": "mrz", "right_source": "mrz", "severity": "string" } ], "decision": "accept", "evidence_sufficient": true, "fixable_by_recapture": true, "model": "string", "mrz": { "decision_source": "string", "independent_available": true, "independent_valid": true, "parsed": { "checks": { "property1": { "expected": "string", "observed": "string", "valid": true }, "property2": { "expected": "string", "observed": "string", "valid": true } }, "date_of_birth": "string", "document_number": "string", "expiry_date": "string", "given_names": "string", "layout": "TD1", "nationality": "string", "raw_lines": [ "string" ], "sex": "string", "surname": "string", "valid": true, "validation_complete": true }, "provider_state": "valid", "provider_validation": "string", "shadow_decision_applied": true, "shadow_state": "valid" }, "names": [ { "confidence": 0, "full_name": "string", "given_names": "string", "language": "string", "script": "string", "source": "mrz", "surname": "string" } ], "recommended_action": "continue" }, "tax_number": "string" }, "review_decision": { "automatic_status": "string", "decided_at": "string", "decision": "string", "source": "string" }, "revision": 0, "status": "string" }, "created_at": "string", "extracted_data": { "date_of_birth": "string", "date_of_issue": "string", "document_number": "string", "document_type": "string", "expiry_date": "string", "extended_data": { "property1": "string", "property2": "string" }, "first_name": "string", "full_name": "string", "full_name_latin": "string", "full_name_native": "string", "full_name_original": "string", "gender": "string", "issuing_country": "string", "last_name": "string", "middle_name": "string", "mrz": "string", "nationality": "string", "ocr": { "additional": { "property1": "string", "property2": "string" }, "address": "string", "barcode": { "property1": "string", "property2": "string" }, "booklet_number": "string", "date_of_birth": "string", "document_class": "string", "document_name": "string", "document_number": "string", "document_series": "string", "document_type": "string", "expiry_date": "string", "field_issues": { "property1": "string", "property2": "string" }, "first_name": "string", "full_name": "string", "full_name_latin": "string", "gender": "string", "issue_date": "string", "issuing_authority": "string", "issuing_authority_name": "string", "issuing_country": "string", "issuing_place": "string", "issuing_state_code": "string", "last_name": "string", "localized": { "property1": { "property1": "string", "property2": "string" }, "property2": { "property1": "string", "property2": "string" } }, "middle_name": "string", "mrz_code": "string", "mrz_data": { "property1": "string", "property2": "string" }, "mrz_type": "string", "nationality": "string", "nationality_name": "string", "native_full_name": "string", "personal_number": "string", "place_of_birth": "string", "portrait": "string", "portrait_position": { "x1": 0, "x2": 0, "y1": 0, "y2": 0 }, "position": { "x1": 0, "x2": 0, "y1": 0, "y2": 0 }, "profession": "string", "reconciliation": { "canonical_name": { "confidence": 0, "full_name": "string", "given_names": "string", "language": "string", "script": "string", "source": "mrz", "surname": "string" }, "confidence": 0, "conflicts": [ { "code": "name_mismatch", "field": "string", "left_source": "mrz", "right_source": "mrz", "severity": "string" } ], "decision": "accept", "evidence_sufficient": true, "fixable_by_recapture": true, "model": "string", "mrz": { "decision_source": "string", "independent_available": true, "independent_valid": true, "parsed": { "checks": { "property1": { "expected": "string", "observed": "string", "valid": true }, "property2": { "expected": "string", "observed": "string", "valid": true } }, "date_of_birth": "string", "document_number": "string", "expiry_date": "string", "given_names": "string", "layout": "TD1", "nationality": "string", "raw_lines": [ "string" ], "sex": "string", "surname": "string", "valid": true, "validation_complete": true }, "provider_state": "valid", "provider_validation": "string", "shadow_decision_applied": true, "shadow_state": "valid" }, "names": [ { "confidence": 0, "full_name": "string", "given_names": "string", "language": "string", "script": "string", "source": "mrz", "surname": "string" } ], "recommended_action": "continue" }, "tax_number": "string" }, "place_of_birth": "string" }, "id": "string", "is_current": true, "issuing_country": "string", "pages": [ { "download_url": "string", "download_url_expires_at": "string", "image_id": "string", "side": "string" } ], "reason_codes": [ "string" ], "session_id": "string", "side": "string", "status": "string", "step_id": "string", "type": "string", "verification": { "checks": [ { "is_authentic": true, "liveness_score": 0, "portrait_replace_score": 0, "printed_copy_score": 0, "rejection_reasons": [ "string" ], "screen_replay_score": 0, "similarity_score": 0, "status": "string", "type": "string" } ], "status": "string" } } ]}Delete applicant data
Submits a deletion request for the applicant's data, including documents, selfies, and verification results, in line with GDPR requirements. Actual deletion is executed only after KnowaKYC approval; after approval, the deletion is irreversible. Required scope: applicants:write.
DELETE
ApiKeyAuthheader
Authorization<token>HMAC-SHA256 Credential=<key_id>, Signature=<hex_signature>. SignedHeaders=x-timestamp is optional. Requires X-Timestamp header.
applicant_id*stringApplicant UUID
X-Timestamp*stringUnix timestamp (seconds, max 5 min drift)
Deletion request created
application/json- response
data?success?booleancurl -X DELETE 'https://example.com/tenant/v1/kyc/applicants/string' \ -H 'X-Timestamp: string'Example Response
{ "success": true, "data": { "created_at": "string", "entity_type": "kyc", "id": "string", "object_id": "string", "object_type": "session", "reason": "string", "rejection_reason": "string", "requested_at": "string", "requested_by_id": "string", "requested_by_name": "string", "reviewed_at": "string", "reviewed_by_name": "string", "status": "pending", "tenant_id": "string", "updated_at": "string" }}For the full field specification, error codes, and request examples, see API reference (OpenAPI).
Identity spelling and evidence completeness
Individual applicant responses (ID, external ID, and detailed view) expose full_name, middle_name, full_name_latin, full_name_native, and full_name_original when supported by current identity evidence. Latin aliases are emitted only for observed Latin-script text; original accents and native spelling are retained without inventing transliteration. name_source identifies the verification result, step, and attempt when names come from legacy document checks. Detailed document_details.ocr retains normalized OCR evidence; document extracted_data includes the full-name aliases for that document.
Current attempt metadata takes precedence over historical results. A new attempt with no result cannot reuse an earlier attempt's names or AML result. Independent profile edits, including explicit empty fields, retain precedence over recognized name parts.
Verification responses expose their selected session_id; each check includes verification_id, step_id, attempt_number, rejection_reasons, and its safe typed contract (including aml). The default verification endpoint continues to select completed sessions. The separate AML response also exposes source correlation and the typed aml contract. Public contracts omit raw provider records and error text.
Profile enrichment is an applicant-scoped asynchronous summary, independent of a particular verification session. Known zero scores/counts and false flags are retained. An unavailable optional read produces an unavailable summary and enrichment_errors; missing enrichment remains absent. Name read failures use name_evidence_unavailable or name_attempts_unavailable, and unavailable collection identity uses collection_identity_unavailable.
Document responses expose known session_id and step_id for legacy and collection records. extracted_data.ocr contains the complete normalized recognition payload only when it belongs to that exact file, tenant, session, step and attempt; collection documents use their own revision-bound recognition. Portraits and geometry are omitted. A missing file association cannot borrow another document's OCR.
When a current OCR result supplies first and last names without a literal full name, the profile display name is composed from those parts of the same document attempt. A missing name part or transliteration is never invented.