ODD Webhook & Decision Making

Ongoing Due Diligence (ODD) is the continuous monitoring of AML decisions against the search activities to detect deviation and ensure compliance with Anti-Money Laundering (AML) regulations.

ODD has been run in the background based on decision status and finding of oddStatus wise the response will push to the webhook URL.

Webhook Sample Response Format

{
    "oddStatus": "new",
    "oddSearchHistoryId": "SH_QXIATXMPtq",
    "onboardDecisionId": "decision_8WX6knjWAs",
    "searchObject": {
        "mode": "advance",
        "sdnType": "entity",
        "searchParams": {
            "name": "M.G. Vermietungsgesellschaft mbH",
            "date": "1998-02-11",
            "idNumber": "529900YKOMNKL9H6AD64",
            "nationality": "Russia"
        },
        "level": "exact"
    },
    "searchDate": "2026-06-24",
    "searchResults": [
        {
            "sanctionId": "SANCL_YDxfjH2WjR",
            "sdnType": "entity",
            "createdAt": "2025-08-27T23:12:42.643Z",
            "updatedAt": "2026-07-01T00:37:51.276Z",
            "caption": "V.M.G. Vermietungsgesellschaft mbH",
            "datasets": [
                "LEI Reference Data"
            ],
            "address": [
                "Arabellastraße 12, 81925 München"
            ],
            "incorporationDate": [
                "1998-02-11"
            ],
            "scoreResults": {
                "matchScore": 90,
                "riskScore": 100
            },
            "topicTags": [
                "Sanction-linked entity"
            ],
            "idNumber": [
                "HRB 119456",
                "529900YKOMNKL9H6AD64"
            ],
            "birthDate": [],
            "gender": [],
            "phone": [],
            "country": [],
            "nationality": [],
            "topics": []
        }
    ],
    "relation": {
        "decision": {
            "meta": {
                "actionButton": [
                    "true_match",
                    "no_match",
                    "false_positive"
                ]
            }
        }
    }
}

{
    "oddStatus": "update",
    "oddSearchHistoryId": "SH_cljEgdfnFy",
    "onboardDecisionId": "decision_TXnOjDikrd",
    "searchObject": {
        "mode": "advance",
        "sdnType": "individual",
        "searchParams": {
            "name": "John Doe",
            "idNumber": "BZT67900",
            "nationality": "india",
            "date": "1995-08-09"
        },
        "level": "broad"
    },
    "searchDate": "2025-12-04",
    "deviation": {
        "topics": {
            "old": [
                "Export controlled",
                "Sanctioned entity"
            ],
            "new": [
                "Sanctioned entity",
                "Export controlled",
                "Debarred entity"
            ]
        }
    },
    "searchResults": [
        {
            "sanctionId": "SANCL_fGcdbJu5Qw",
            "sdnType": "individual",
            "createdAt": "2025-08-29T20:57:50.493Z",
            "updatedAt": "2026-06-30T23:53:47.255Z",
            "caption": "Johnson Andre",
            "datasets": [
                "DFAT / Australian sanction",
                "FPS - Belgium Finance Sanction",
                "CA Consolidated Sanction List",
                "CHE SECO",
                "EU Finance Sanction",
                "US CSL (Denied Persons List)",
                "ZAF Targeted Financial Sanctions"
            ],
            "country": [
                "China"
            ],
            "address": [
                "Village de Dieu, Martissant, Port-au-Prince",
                "PORT-AU-PRINCE"
            ],
            "nationality": [
                "China",
                "Haiti"
            ],
            "birthDate": [
                "1997"
            ],
            "gender": [
                "male"
            ],
            "scoreResults": {
                "matchScore": 10,
                "riskScore": 100
            },
            "topicTags": [
                "Debarred entity",
                "Sanctioned entity",
                "Export controlled"
            ],
            "idNumber": [],
            "phone": [],
            "incorporationDate": [],
            "topics": []
        }
    ],
    "relation": {
        "decision": {
            "meta": {
                "actionButton": [
                    "true_match",
                    "no_match",
                    "false_positive"
                ]
            }
        }
    }
}

{
    "oddStatus": "delete",
    "investigationId": "INVES_BPj28P7BFS_decision_aXJvHfMiyX",
    "oddSearchHistoryId": "SH_8kkDPT1osR",
    "onboardDecisionId": "decision_aXJvHfMiyX",
    "searchObject": {
        "mode": "advance",
        "sdnType": "individual",
        "searchParams": {
            "name": "John Doe",
            "idNumber": "CFY097",
            "nationality": "china",
            "date": "1988-09-10"
        },
        "level": "broad"
    },
    "searchDate": "2026-05-08",
    "searchResults": [],
    "relation": {
        "decision": {
            "meta": {
                "actionButton": [
                    "track"
                ]
            }
        }
    }
}

ODD Decision Making API

This API is used to make ODD (Ongoing Due Diligence) decisions based on ODD deviation findings. It supports decision-making for new, updated, and deleted ODD records.

The ODD decision process is used to continuously monitor AML decisions and ensure that any changes identified during ongoing due diligence are handled appropriately.

The API executes the decision based solely on the action requested by the client and updates the corresponding ODD records accordingly.

POST https://secctrl.tutelar.io/api/v1/aml/search/decision-make/:oddSearchHistoryId

Header

Name

Value

Content-Type

multipart/form-data

Sample Response

{
   "success": true,
   "code": 201,
   "message": "Decisions created successfully",
   "data": {
       "decisionId": "decision_atanqCUkqz",
       "decisionAt": "2025-12-04T10:39:16.382Z",
       "decisionStatus": "true_match"
   }
}

{
   "success": false,
   "code": 1001,
   "message": "Invalid Search History Id",
   "data": {}
}
{
   "success": false,
   "code": 1001,
   "message": "Decision Status field is missing",
   "data": {}
}
{
   "success": false,
   "code": 1001,
   "message": "Invalid data received from Decision Status",
   "data": {}
}
{
   "success": false,
   "code": 1001,
   "message": "Invalid Sanction",
   "data": {}
}
{
   "success": false,
   "code": 1001,
   "message": "Already Decision placed for this search id",
   "data": {}
}
{
    "success": false,
    "code": 1001,
    "message": "Please Enter any one sanctionId | adverseResultId",
    "data": {}
}
{
    "success": false,
    "code": 1001,
    "message": "Already Decision placed for this search id",
    "data": {}
}

Path param values

Path parameter

Type

Is Mandatory

Description

oddSearchHistoryId

String

yes

ODD Search history Id will be generated for every Individual search made in the client panel.

Post values are:

Post Parameter

Type

Is Mandatory

Description

decisionStatus

String

Yes

Status of a Decision ( "true_match," "false_positive," or "no_match" and "track" )

sanctionId

String

Yes

sanctionId is a unique identifier. It is required to make a decision only when searchResults data is available. If the decision is Track, the sanctionId is not required for the AML standalone search product.

remarks

String

Add remarks for decision purpose.

file

Binary

Upload reference documents for decision.

Sample post data format

If make decision for aml alone search result

{
   "decisionStatus": "true_match",
   "sanctionId": "SANCL_yZwvS457ed",
   "remarks": "Testing ",
   "file": "sample.pdf"
}

{
   "decisionStatus": "track",
   "remarks": "Testing ",
   "file": "sample.pdf"
}

Success response :

{
   "success": true,
   "code": 201,
   "message": "Decisions created successfully",
   "data": {
       "decisionId": "decision_atanqCUkqz",
       "decisionAt": "2025-12-04T10:39:16.382Z",
       "decisionStatus": "true_match"
   }
}

Failure response :

{
   "success": false,
   "code": 1001,
   "message": "Invalid Search History Id",
   "data": {}
}
{
   "success": false,
   "code": 1001,
   "message": "Decision Status field is missing",
   "data": {}
}
{
   "success": false,
   "code": 1001,
   "message": "Invalid data received from Decision Status",
   "data": {}
}
{
   "success": false,
   "code": 1001,
   "message": "Invalid Sanction",
   "data": {}
}
{
   "success": false,
   "code": 1001,
   "message": "Please provide valid searchData Mode",
   "data": {}
}
{
   "success": false,
   "code": 1001,
   "message": "Enter valid Search Data",
   "data": {}
}
{
   "success": false,
   "code": 1001,
   "message": "Invalid date formate on Search Date ",
   "data": {}
}
{
   "success": false,
   "code": 1001,
   "message": "Please enter Search History Id",
   "data": {}
}
{
   "success": false,
   "code": 1001,
   "message": "Already Decision placed for this search id",
   "data": {}
}

PreviousDecision Details

NextSearch

Last updated 8 days ago