Customer
Represents an individual or company undergoing checks.
Case
A container for all checks and documents related to a single customer investigation. API interactions work primarily through Cases.
Check
A specific verification process, like a sanctions screening or address verification. One check would be one “alert” or “hit” - not multiple. For each check within a KYB or EDD, such as UBOs or web presence, a new check is created.
Document
Supporting files, such as identity documents or proofs of address. Not required. A sanctions screening might solely rely on details provided in the Customer object, or the Customer might have supporting documentation such as a driver’s license.
Relationships
The diagram below illustrates how these models are interconnected. ACustomer can have multiple Cases, each Case can have multiple Checks, and Documents can be associated with a Case or a Check.
What to link a document to?
Documents can be associated with a Case or a Check, but only one at a time. Each association serves different purposes:- Linking to a Case: General document storage for the entire case workflow. Recommended starting point.
- Linking to a Check: More precise. Isolated work for the AI agent and faster processing. Useful is check types such as Proof of Address.
When creating a case, you can attach documents at the case level via
document_ids, or attach them to a specific check by includingdocument_idsinside that check object.

