Skip to main content
A Case is the central hub for a specific investigation. It acts as a container that groups together all the Checks and Documents related to a single screening workflow for a Customer. Think of a Case as a folder for a particular compliance event, such as onboarding a new user, conducting a periodic review, or investigating a suspicious transaction. You create a case, attach checks to it (either at creation time or later), and all processing and results are tracked within its scope.
​
id
integer
required
A unique identifier for the case.
​
customer
object
required
The customer object associated with this case.
​
webhook_url
string
An optional URL to receive notifications upon case completion.
​
note
string
Internal note about the case.
​
risk_score
number
An overall risk score for the case, often aggregated from individual checks.
​
outcome
string
The final decision for the case, which can be ACCEPTED, REJECTED, or PENDING.
​
delete_after
integer
Number of days until the case is automatically deleted. Use 0 for immediate deletion, or -1 for indefinite retention (never delete). Max 365. Defaults to -1 (indefinite).
​
checks
array
A list of check objects associated with this case.