Case (or Sessions)

A Case—also referred to as a Verification Session—represents a single verification request for either a user (KYC) or a business (KYB). Every time a verification is initiated using a template, AiPrise creates a new case. This case tracks the entire lifecycle of the verification, including execution progress, status changes, results, and all associated metadata.

Cases allow you to:

Execute verification workflows
Track run status and final decision
Collect and store input data
Receive callbacks and notifications
Map verification attempts to your internal systems

Case Lifecycle

Every case progresses through a predictable series of states:

Status	Description
NOT_STARTED	Case created, workflow has not begun
SUBMITTED	User submitted details via hosted UI (if applicable)
RUNNING	Checks are actively executing
PENDING	Waiting for additional data or third-party callback
COMPLETED	Workflow execution finished successfully
FAILED	An error prevented the workflow from completing