Workflows

Workflows are how most checks are initiated.

We have big plans for workflows in the future including them being customizable and event driven. But for now we only have basic workflows available that run single checks.

Available workflows

Workflow name	Checks initiated
kyc	KYC
fin-vul	Financial vulnerability
aml	AML
bav	BAV

Execute workflow

Executes a workflow on the desired case.

Endpoint	api/workflows/execute
Method	POST
Content type	application/json

Fields

Property	Required	Max Length	Notes
caseId	✅	integer (int64)	Unique CaseId to run checks for
workflowName	✅		Either 'kyc', 'fin-vul' or 'aml' depending on which service you want to run
workflowOptions			Object of key-boolean, workflow options listed below
externalReference			Idempotency key as outlined here

WorkflowOptions

Property	Value	Notes
enableOngoingMonitoring	true or false	currently only availble on AML, sets if the person should be checked recurringly
bankAccountId	long	currently only available for BAV, sets ID of the bank account that the BAV check should be performed on. Get the bank account ID via Bank Account Management

Request

A request just requires a case Id and a workflow name.

{
    "caseId":"123",
    "workFlowName":"kyc", 
    "workflowOptions": { // optional
        "enableOngoingMonitoring": "false" // optional
    },
    "externalReference": "abc123" // optional
}