AML - Checkresult API (New)

2026-05-28 01:47

Important Notice:

All request and response parameters are strictly subject to the official API documentation.
The API response may contain fields not defined in the documentation. These fields are for internal debugging purposes only and are not guaranteed to be stable or compatible. Do not rely on these fields in production environments. ZOLOZ reserves the right to modify or remove these fields at any time without prior notice.

Overview

API URL: /api/v3/aml/nss/checkTasks

API Description: Provides real-time scanning of related tasks.

Structure

Request Parameters

Parameter	Data Type	Max Length	Description	Example
eventId	String	32B	Required. The call ID generated by the AML system. Obtain it from screen (new).	"6728d09e2113b33b6cc7e47a361c****"

Response Parameters

Parameter

Data Type

Is return required?

Description

Example

result

Result

Yes

The API request result, which contains information about the result of the API request, such as status and error codes.

{

"resultStatus": "S",

"resultCode": "SUCCESS",

"resultMessage": "Success"

}

caseDetails

List<ZolozAlertTaskBO>

For more details on case results, see ZolozAlertTaskBO.

[

{

"decision": "REJECT",

"status": "CLOSED",

"taskId": "A2022112130307****",

"type": "SANCTION",

"customerId": "2088000****",

"crrRiskLevel": "",

"createTime": "1693221462732",

"updateTime": "1693221462732",

"modifier": "12345678@163.com"

}

]

ZolozAlertTaskBO

Parameter	Data Type	Is return required?	Description	Example
taskId	String	No	Unique case Id for a case.	"A2022112130307183A"
type	String	No	Case types. Possible values are as below: `PEP`: Politically Exposed Person `SANCTION`: sanctioned individuals and entities `NEGATIVE_NEWS`: individuals and entities associated with bad press `INTERNAL_LIST`: custom list `EDD`: Enhanced Due Diligence	"SANCTION"
status	String	No	Case status. The following values are supported: `NEW`: newly created alert case, not reviewed yet. `REVIEW`: alert case is currently being reviewed. `CLOSED`: alert case review has finished.	"CLOSED"
decision	String	No	Case review results. When the case type is `PEP/SANCTION/NEGATIVE_NEWS/INTERNAL_LIST`,the following case review results are returned: `ACCEPT`: Non-hit `REJECT`: Hit When the case type is `EDD`, the following case review results are returned: `Maintain`: Maintains the existing risk rating without manual adjustment. `Adjust`: Manually adjust the risk rating. `Terminate`: Terminate relationship with the customer.	"ACCEPT"
crrRiskLevel	String	No	Customer risk rating, this field is returned for EDD case types. `HIGH`: high risk `MEDIUM`: medium risk `LOW`: low risk	"HIGH"
customerId	String	No	Customer ID in merchant system.	"2088000****"
createTime	Timestamp	No	Case creation time in Unix timestamp format (milliseconds)	"1693221462732"
updateTime	Timestamp	No	Case update time in Unix timestamp format (milliseconds)	"1693221462732"
modifier	String	No	Case modifier.	"12345678@163.com"

Samples

Request Sample

The following sample shows what a request sent from the merchant server looks like.

copy
{
    "eventId": "6728d09e2113b33b6cc7e47a361c****"
}

Response Sample

The following sample shows what a response returned from the ZOLOZ server looks like.

copy
{
    "caseDetails": [
        {
            "decision": "REJECT", 
            "status": "CLOSED", 
            "taskId": "A2022112130307****", 
            "type": "SANCTION", 
            "customerId": "2088000****", 
            "crrRiskLevel": "", 
            "createTime": "1693221462732", 
            "updateTime": "1693221462732", 
            "modifier": "12345678@163.com"
        }
    ], 
    "result": {
        "resultCode": "SUCCESS", 
        "resultMessage": "Success", 
        "resultStatus": "S"
    }
}