For the complete documentation index, see llms.txt. This page is also available as Markdown.

Event Reference

This page lists every event type recorded in the 1Kosmos Event Logs for ID Verification, along with the fields captured for each event. Events are grouped by activity category so you can quickly find


How to read an entry

Each event below includes:

  • Event code — the identifier that appears in the logs (for example, E_IDV_INITIALIZATION).

  • Name — a plain-language description of what the event represents.

  • Notes — any conditions that affect when the event is recorded, where applicable.

  • Fields captured — the data fields included in the event's payload.

Note: If the internet is unavailable at any stage of the verification process, no events are triggered.

ID Verification Activity

E_IDV_INITIALIZATION — ID verification session started

Triggered when a user begins their ID verification process on the Initialization screen.

Fields captured: eventCategory , type , event_name , version , event_ts , ip_address , user_agent , sessionId , screen_name , status , SessionInfo._id , SessionInfo.id , dvcID , tenantDNS , tenantId , communityName , communityId , documentType , expiryTS , createdTS , user.username , user.firstname , user.lastname , request_id , app_id , event_id , timestamp , epoch_time , tenant_id , community_id , eventName

E_IDV_USER_CONSENT — User consent captured

Triggered when a user gives consent for sharing their information. Verification status is "In Progress" while reading the consent notice and becomes "Completed" after consent is given.

Note: If a user declines the consent notice, the event is triggered with status "Declined" and the user is prompted to reinitiate verification.

Fields captured: eventCategory , type , event_name , version , event_ts , ip_address , user_agent , sessionId , screen_name , status , SessionInfo._id , SessionInfo.id , dvcID , tenantDNS , tenantId , communityName , communityId , documentType , expiryTS , createdTS , user.username , user.firstname , user.lastname , request_id , app_id , event_id , timestamp , epoch_time , tenant_id , community_id , eventName

E_IDV_DOCUMENTINSTRUCTION — Document instructions reviewed

Triggered when a user reviews the instructions before starting the document scan.

Fields captured: screen_name , status , eventCategory , event_name , type , version , event_ts , ip_address , user_agent , sessionId , sessionInfo._id , sessionInfo.id , dvcID , tenantDNS , tenantId , communityName , communityId , documentType , expiryTS , createdTS , user.firstname , user.lastname , startedTS , request_id , app_id , event_id , timestamp , epoch_time , tenant_id , community_id , eventName

E_IDV_DOCUMENTPREVIEW — Document preview displayed

Triggered when a user previews their document before capturing it.

Fields captured: screen_name , status , eventCategory , event_name , type , version , event_ts , ip_address , user_agent , sessionId , SessionInfo._id , SessionInfo.id , dvcID , tenantDNS , tenantId , communityName , communityId , documentType , expiryTS , createdTS , username , lastname , startedTS , request_id , app_id , event_id , timestamp , epoch_time , tenant_id , community_id , eventName

E_IDV_DOCUMENTCAPTURE — Document captured

Triggered when a user scans their document for capture. Verification status is "In Progress" during capture and becomes "Completed" after capture.

Note: If an unsupported document is presented, the event is triggered with status "Verification Not Performed" with one of the following reason codes: "Unsupported document", "No document was presented", or "Document scan not completed. Please try again."

Fields captured: eventCategory , type , event_name , version , event_ts , ip_address , user_agent , sessionId , screen_name , status , SessionInfo._id , SessionInfo.id , dvcID , tenantDNS , tenantId , communityName , communityId , documentType , expiryTS , createdTS , user.username , user.firstname , user.lastname , document_liveness_front_classInfo , document_liveness_back_classInfo , document_liveness_front , document_liveness_back , request_id , app_id , event_id , timestamp , epoch_time , tenant_id , community_id , eventName

E_IDV_SELFIEINSTRUCTION — Selfie instructions reviewed

Triggered when a user reviews the instructions before taking their selfie.

Fields captured: screen_name , status , eventCategory , event_name , type , version , event_ts , ip_address , user_agent , sessionId , sessionInfo._id , sessionInfo.id , dvcID , tenantDNS , tenantId , communityName , communityId , documentType , expiryTS , createdTS , user.firstname , user.lastname , startedTS , request_id , app_id , event_id , timestamp , epoch_time , tenant_id , community_id , eventName

E_IDV_SELFIEPREVIEW — Selfie preview displayed

Triggered when a user previews their selfie before tapping the capture button.

Fields captured: screen_name , status , eventCategory , event_name , type , version , event_ts , ip_address , user_agent , sessionId , sessionInfo._id , sessionInfo.id , dvcID , tenantDNS , tenantId , communityName , communityId , documentType , expiryTS , createdTS , user.firstname , user.lastname , startedTS , request_id , app_id , event_id , timestamp , epoch_time , tenant_id , community_id , eventName

E_IDV_SELFIECAPTURE — Selfie captured

Triggered when a user captures their selfie.

Fields captured: eventCategory , type , event_name , version , event_ts , ip_address , user_agent , sessionId , screen_name , status , sessionInfo._id , sessionInfo.id , dvcID , tenantDNS , tenantId , communityName , communityId , documentType , expiryTS , createdTS , user.firstname , user.lastname , startedTS , selfie_liveness.docType , selfie_liveness.docId , selfie_liveness.type , selfie_liveness.authority , selfie_liveness.proofedBy , selfie_liveness.ts , selfie_liveness.verified , selfie_liveness.result , request_id , app_id , event_id , timestamp , epoch_time , tenant_id , community_id , eventName

E_IDV_DOCUMENT_SUBMISSION — Document submitted

Triggered when a user submits their scanned document.

Fields captured: eventCategory , type , event_name , version , event_ts , ip_address , user_agent , sessionId , screen_name , status , SessionInfo._id , SessionInfo.id , dvcID , tenantDNS , tenantId , communityName , communityId , documentType , expiryTS , createdTS , user.username , user.firstname , user.lastname , request_id , app_id , event_id , timestamp , epoch_time , tenant_id , community_id , eventName

E_IDV_SESSION_ABANDONED — Session abandoned

Triggered when a session is marked as Abandoned.

Fields captured: eventCategory , type , event_name , version , event_ts , ip_address , user_agent , sessionId , sessionInfo._id , sessionInfo.id , dvcID , tenantDNS , tenantId , communityName , communityId , documentType , status , maxRetries , expiryTS , createdTS , user.firstname , user.lastname , expireSessionInMin , abandonSessionInMin , abandonedTS , startedTS , screen_name , reason , attemptIndex , request_id , app_id , event_id , timestamp , epoch_time , tenant_id , community_id , eventName

E_IDV_SESSION_EXPIRED — Session expired

Triggered when a session is marked as expired.

Fields captured: eventCategory , type , event_name , version , event_ts , sessionId , sessionInfo._id , sessionInfo.id , dvcID , tenantDNS , tenantId , communityName , communityId , documentType , status , maxRetries , expiryTS , createdTS , user.firstname , user.lastname , expireSessionInMin , abandonSessionInMin , screen_name , reason , attemptIndex , request_id , ts , app_id , uuid , journeyId , event_id , timestamp , epoch_time , tenant_id , community_id , eventName

E_IDV_DOCUMENT_VALIDATE — Document validated

Triggered when a submitted document is validated.

Note: If an unsupported document is presented, the event is triggered with status "Verification Not Performed" with reason code indicating an unsupported document was presented.

Fields captured: eventCategory , type , event_name , version , event_ts , ip_address , user_agent , sessionId , screen_name , status , SessionInfo._id , SessionInfo.id , dvcID , tenantDNS , tenantId , communityName , communityId , documentType , expiryTS , createdTS , user.username , user.firstname , user.lastname , startedTS , completedTS , resultStatus , document_firstname , document_lastname , document_id , document_expiry , request_id , app_id , event_id , timestamp , epoch_time , tenant_id , community_id , eventName

Last updated

Was this helpful?