Skip to main content
The Customer model is the starting point for any investigation. It holds the core identity information for the individual or company you want to screen. You can create a Customer object independently before creating a case, or create it inline when you create a new case. Once a customer is created, you can reuse their id to run multiple cases over time, which is useful for ongoing monitoring or periodic reviews. When creating a customer inline with a case, if a customer with the same external_id already exists in your organization, the existing customer is updated. All of full_name, customer_type, and input_details are replaced — omitted fields are set to null. If you only want to reuse the customer without changing it, pass customer_id instead.
​
id
integer
required
A unique identifier for the customer.
​
external_id
string
An optional identifier from your system to link customers.
​
full_name
string
required
The full legal name of the individual or company.
​
customer_type
string
The type of customer, either INDIVIDUAL or COMPANY.
​
input_details
object
A flexible JSON object for additional customer details like date of birth, address, or registration number.
​
delete_after
integer
Number of days until the customer is automatically deleted. Use 0 for immediate deletion, or -1 for indefinite retention (never delete). Max 365. Defaults to -1 (indefinite).