Create Case
Create a new case for a customer. You can either provide an existing customer_id or create a new customer inline. By default, the case is automatically started after creation (equivalent to calling POST /cases//start/). Set auto_start=false to create without starting.
Customer matching: 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.
Authorizations
OAuth2 access token obtained from POST /api/oauth/token/ using client credentials.
Body
Write serializer for GenericCase creation.
ID of an existing customer for this case
Customer data to create a new customer with this case
Webhook sent on case completion.
511A list of checks to create with this case.
List of document IDs to link to this case
Number of days until deletion. Use 0 for immediate deletion, or -1 for indefinite retention (never delete). Defaults to -1.
Slug of a CaseConfig or DualCaseConfig. For a CaseConfig, auto-generates checks from the config. Cannot be used together with 'checks'. For a DualCaseConfig (pairs KYB + KYC configs), creates a parent KYB case; when started, child KYC cases are auto-created for each shareholder extracted from documents.
Whether to automatically start processing the case after creation. Defaults to true. Set to false to create a case without starting it (you can start it later via POST /cases/{id}/start/).
Response
Read-only serializer for GenericCase with related objects.
Nested customer serializer for GenericCase responses.
Risk score (max of check risk scores for the case).
ACCEPTED- AcceptedREJECTED- RejectedPENDING- Pending
ACCEPTED, REJECTED, PENDING, null Webhook sent on case completion.
511Days until deletion. -1 means never delete.
-2147483648 <= x <= 2147483647