> For the complete documentation index, see [llms.txt](https://docs.1kosmos.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.1kosmos.com/identity-verification/core-concepts/event-reference.md). # Event Reference *** ### **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` --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.1kosmos.com/identity-verification/core-concepts/event-reference.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.